Version 1.1 of the Human Services Data API Specification

[This post is from Kin Lane, the API Evangelist, who is serving as Open Referral’s deputized Technical Lead for our OpenAPI specification project. Thanks Kin!]

Version 1.1 of the Human Services Data API specification (HSDA 1.1) is now available for review and comment.

This is an alpha implementation of our OpenAPI specification. It is built upon version 1.1 of Open Referral’s Human Services Data Specification (HSDS). Whereas HSDS is designed to facilitate raw exchange and bulk publication of resource directory data, the HSDA serves as a common protocol for resource directory APIs.

To facilitate testing, we’ve made the HSDA available in this demonstration portal. This portal is a redeployable (and forkable) reference implementation that provides guidance for working with the HSDA protocols. Implementers can use it to easily set up a “developers’ area” for their own API implementation.

Moving forward, we’ll collect feedback from stakeholders and reiterate this process twice more over the course of the summer. We’re setting a day/time for the next Open Referral Assembly now; if you’re interested, indicate your availability here. Continue reading

Continue reading