Authentication

This article provides an overview of the authentication schemes that our APIs use, organized by the header or other mechanism they use to authenticate with our servers.

Tokens​

API tokens may expire based on user or developer actions, depending on your account type. Most tokens expire after 30 days.

Our APIs use Bearer tokens for authentication. Bearer tokens contain signed payloads that servers decrypt to verify request authenticity. All Bearer token requests require two steps: making the request and providing a valid token.

Most REST endpoints use the Authorization header for authentication. Your API account must have appropriate permissions for the request to succeed.

Temporary Bearer Token Generation​

To generate a temporary token, log in to the platform.

Permanent Bearer Token Generation​

To generate a permanent token:

1. Log in to the Axiom platform and navigate to suppliers.axiomdata.io/developers
2. Go to Settings and select API Keys

3. Click "Create API Key" from the landing page

4. Enter a name for your API token

5. Save the generated token securely - you won't be able to view it again

Request Examples​

curl --location
  --request GET 'https://api.axiomdata.io/api/suppliers/...'
  --header 'Authorization: Bearer XXXXXXXXXX'

curl --location
  --request POST 'https://api.axiomdata.io/api/suppliers/...'
  --header 'Authorization: Bearer XXXXXXXXXX'
  --header 'Content-Type: application/json'
  --data-raw '{...}'

curl --location
  --request PUT 'https://api.axiomdata.io/api/suppliers/...'
  --header 'Authorization: Bearer XXXXXXXXXX'

curl --location
  --request DELETE 'https://api.axiomdata.io/api/suppliers/...'
  --header 'Authorization: Bearer XXXXXXXXXX'