Authentication

We have now released our APIs V5 and V4 with new API Key authentication protocol !
BasicAuth is though still available for former V4 users.

Check the domains and urls section below, to use the right urls depending on the environment, version and authentication you’ll use.

401 Unauthorized

In case the authentication is incorrect (bad credentials) when calling a route, you’ll always receive a “401 Unauthorized” http return code.

API domains and urls context paths

Depending on the API version, the authentication protocol and the environment you choose to make your calls on, the domain and context path of the urls are different:

PRODUCTION COLT

  • API Key Auth :
    • Get new token : https://api.actito.com/auth/token
    • V5 : https://api.actito.com/v5
    • V4 : https://api.actito.com/v4
  • Basic Auth :
    • V4 : https://api.actito.com/ActitoWebServices/ws/v4

PRODUCTION AWS

  • API Key Auth :
    • Get new token : https://api1.actito.com/auth/token
    • V5 : https://api1.actito.com/v5
    • V4 : https://api1.actito.com/v4
  • Basic Auth :
    • V4 : https://api1.actito.com/ActitoWebServices/ws/v4

PRODUCTION EQUINIX

  • API Key Auth :
    • Get new token : https://api3.actito.com/auth/token
    • V5 : https://api3.actito.com/v5
    • V4 : https://api3.actito.com/v4
  • Basic Auth :
    • V4 : https://api3.actito.com/ActitoWebServices/ws/v4

TEST

  • API Key Auth :
    • Get new token : https://apitest.actito.com/auth/token
    • V5 : https://apitest.actito.com/v5
    • V4 : https://apitest.actito.com/v4
  • Basic Auth :
    • V4 : https://apitest.actito.com/ActitoWebServices/ws/v4
Env variables

In all the “request test makers” of this documentation, you’ll see the use of environment variables : $$.env.xxx. If you wish to have all those test makers prefilled using your own default values, you just have to pass those xxx values as query params to the urls of this documentation site. For example : to have the quick-start use case test maker prefilled with the TEST environment domain, call the urls : /menu/use-cases/quick-start?domain=apitest.actito.com. Then feel free to bookmark this documentation portal urls with the query params that fit your needs.