Skip to main content

Authentication

The IOI API uses Basic-Auth for API authentication. As basic auth uses a secret/key (username/password) combination, these can be created and managed under "Dev Tools > API Access Keys".

Remember that your API key is a secret! Do not share it with others or expose it in any client-side code (browsers, apps). Production requests must be routed through your own backend server where your API key can be securely loaded from an environment variable or key management service.

All API requests must include your API key in an Authorization HTTP header as follows:

Basic <Base64 encoding of Api Key:Secret>

After encoding, it should look similar to this:

Authorization: Basic YmNkODQwM2QtMTVjMC00Njk2LTgxODYtZGI5YjAzYTY2MzY0OnF4T29XS3g5VG5yRnN3dndzWG9mN0laNA==

Say Hello#

Verify that you are able to authenticate by hitting our test endpoint.

GET: https://api.{ENV}.dais.com/ioi/v3/hello

curl --location --request GET 'https://api.{ENV}.dais.com/ioi/v3/hello' \--header 'Authorization: Basic <yourAuthHere>'