Authentication

When using the Movio Exhibitor API, you will need to authenticate your requests. This is done by obtaining an access token from our token issuer and then using that token to authenticate requests to the Movio Exhibitor API.

Credentials

When you want to use the Movio Exhibitor API, you will need to obtain a client_id and client_secret from the Movio EQ application. These credentials are used to obtain a token from the token issuer. The token is then used to authenticate requests to the Movio Exhibitor API.

⚠️ The client_id and client_secret should be kept secret and should not be shared with anyone. If you suspect that the credentials have been compromised, then please rotate the credentials in the Movio EQ application.

Token

With your client_id and client_secret, you can obtain a token from the token issuer. The token is used to authenticate requests to the Movio Exhibitor API. The token is obtained by using the OAuth2 client_credentials flow. The issued token will usually be valid for 24 hours. This means that you will need to obtain a new token every 24 hours.

⚠️ You should handle the token with care since it can be used to access the API containing your sensitive data. Depending on the token scopes, this might also include the option to delete your data. We'll not be able to blacklist a token if it's compromised, so you should always keep it safe.

Token Issuer

The Movio Exhibitor API is designed to ensure that personal data is handled in a secure and compliant manner depending on where in the world you are located. This means that users of the API need to obtain a token from the token issuer located in their region. Depending on the region, the URL for the token issuer will be different. Please see the table below for the token issuer URLs.

Region Token Issuer URL
EU https://auth-eu.eq.movio.co/oauth/token
US https://auth-us.eq.movio.co/oauth/token

Audience

When requesting a token from the token issuer, the audience should be set to the URL of the API. The URL of the API will be different depending on the region. Please see the table below for the API audiences.

Region API URL
EU https://exhibitor-api.eu.eks.movio.co
US https://exhibitor-api.us.eks.movio.co