Calling the API

The Knowledge Services API is accessed via a URL string which can include the following functions.

Functions

  • Searching
    Search the data, combine criteria, filter by look-ups
  • Getting
    Used for getting a single record, all records or child items in a hierarchy
  • Counting
    Counts of documents, organisations and items within categories

URL structure

http://api.ids.ac.uk/openapi/ site / object / function / parameter / query

Read more

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.ids.ac.uk/openapi/eldis/search/documents/short?q=undp

UsingĀ cfml:

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

2 Responses to “Calling the API”


Leave a Reply

Your email address will not be published. Required fields are marked *

IDS Open API

The IDS Knowledge Services API button

Your feedback

Please let us know if any of our documentation is not clear, or you have an queries, using the comments box at the bottom of each page.