openreferral / api-specification

This is the working repository for Open Referral's Human Services Data API protocols.
https://openreferral.readthedocs.io/en/latest/hsda/
Other
29 stars 13 forks source link

Webhooks #36

Open kinlane opened 7 years ago

kinlane commented 7 years ago

I want to begin mapping out the webhooks guidance for future versions of the specification. I'd like to find several webhook implementations we could use to model the external push aspects of an implementation, making things more event oriented.

NeilMcKLogic commented 7 years ago

Twilio has a pretty good model in their API. 2-way SMS'ing is a pretty event-y architecture. So is Sendgrid's, which is email/SMTP. It's exciting to think about what we could do with a well crafted webhook model, actually. It would truly enable federating data at a potentially large scale.

kinlane commented 7 years ago

A couple weeks bag in preparation for a call, I had done a significant amount of research into the webhook implementations of top providers, which you can find the first wave here.

I am continuing that research, going through other implementations (Twilio included), and understanding features, building a common specification that can be used as the HSDA Orchestration specification / guidance:

This work is ongoing, and occurring alongside my work on the API Orchestration system + spec.