Authorisation

Before you can do anything with the API you will have to be authorised with the API service. First you will have to register for an API key. The system will send you an email with a link you need to follow, and then you need to fill in your profile, including agreeing to the Terms and Conditions that cover usage of the API.

Authentication

You can authenticate your call to the API, using your GUID, in the header of the HTTP GET request.

Below are some examples of how to make an authenticated call to the API.

Using curl:

curl -X GET -H "Accept: application/json" -H "Token-Guid: 9827f62a-8bbc-4d22-96b4-771d08859926" http://api.okhub.org/v1/hub/search/documents/short?q=undp

Using cfml:

<cfhttp url="http://api.okhub.org/v1/hub/search/documents/short?q=undp" method="get" result="getResults">
<cfhttpparam type="header" name="Token-Guid" value="9827f62a-8bbc-4d22-96b4-771d08859926">
</cfhttp>