Get A Free HSLynk Developer Test Account

If you are a software developer at a public/nonprofit agency, or a software vendor, you can build apps that HSLynk Warehouse customers can use.

Health and human services apps can access potential app customers' data within the HSLynk data warehouse.  Below, we walk you through getting a trusted app account, so you can start writing apps like the Community Technology Alliance's HOME App https://github.com/ctagroup/home-app. So, you can create your app, demo it to one or more customers, and if they agree to activate your app, customers can use your app to access their data. Next post, we'll walk you through using the developer sandbox data to test your app with our open source APIs: https://api.hslynk.com.

For an app to communicate with HSLynk, it must be trusted by the HSLynk platform. When your app is trusted, it receives a Trusted App ID and Secret Key, presented with each web request.

To apply for your app to be trusted, first the developer must obtain an account. To get a developer account for HSLynk, and a trusted app ID for each app you are building, there is a workflow to follow.

First, you create a user account by navigating to https://developers.hslynk.com, as shown in the following screen capture.

login page1

After you click the blue "Create Account" button pictured above, you will receive a verification email with a link.

account verification

By clicking it, you will be logged in. Click on the "Documentation" tab. You will see a workflow diagram explain the process of getting a trusted app id and secret.

documentation page 2

First, you create one or more containers, which are essentially just an "app group", for apps that have similar functionality and access the same sets of APIs. When you make a container, you actually pick which APIs you plan to use (but you can change the selected APIs later, if you change your mind).

containers page 4

Then, as shown in the following screens, you add apps, with descriptions for each, to the containers you had created in the last step.

apps page 5

Adding an app description:

app details page 6

Stay tuned for our next post soon, describing a "Hello World" app using the Developer Sandbox with a Trusted App!