If you are a software at a public/nonprofit agency integrating HSLynk with your legacy system, or a software vendor building human services apps, you'll need a Trusted App account. Here's a run-through of the automated portal for obtaining one.

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.  Then, you can create your app, and offer it to customers or clients.  Customers/clients may then activate your app for their users, and then users can use your app to create/edit/update/delete data the users are authorized to access in HSLynk using our open source APIs: https://docs.hslynk.com.

When an app is trusted by the HSLynk platform, 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