APIs Documentation

How to integrate APIs

Ianum® API is organized around REST. Our API has predictable resource-oriented URLs, returning JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Every Ianum® API requires an access token. If token is not passed or is invalid, the API will return a 401 - Unauthorized error.

You have to use the OAuth 2.0 client credentials flow to obtain an access token.

All the API calls will return a JSON element, this is why we suggest to put in the headers also the following values:

'Content-Type: application/json'
'Accept: application/json'

Errors

There can be errors thrown by endpoints. A more details explanation about how do we treat errors can be found in the Errors section.