Instructions for testing HAPI V1

Documentation for HAPI V1 is available here including code examples:
HDX HAPI - The Humanitarian API

The ReadTheDocs for HAPI is public and so does not contain the API URL in both the text and the code examples.  Please replace https://placeholder.url with https://hapi-testing.innovation.humdata.org to get the testing links.

Technical documentation is available and includes a test environment for querying the API:

https://hapi-testing.innovation.humdata.org/docs

The root of the API is: https://hapi-testing.innovation.humdata.org

Current status

In HAPI V1 two themes have been added, 3W and Population for 3 countries. In addition, supporting tables such as admin divisions, sector names and age ranges are also present.

The data in the API represents the most current data as of the time of deployment. It is not yet possible to query by date to get historical data, and the data is not automatically updated in this testing version.

Please do not use the API in any public facing products and please note that as the product is still under development the endpoints should not be considered stable and are subject to change.

Approach

Please make use of the documentation to get started on the API. It should contain all you need, but it is a work in progress. If anything in the documentation is not clear, please ask in the Slack channel (see the email you received) for guidance.

The API can either be queried via a script or using the test environment here:

HDX HAPI - OpenAPI Docs

Possible queries to make

Here are some suggested queries to make use of the API. 

Possible analysis using data from the API

These suggestions would require further processing of the data

Feedback

Please provide feedback in the Slack channel (see the email you received for the link). The HAPI team will convert them into tickets.