Skip to content

Authentication

All API requests require authentication using a Bearer token.

Obtaining a Token

Tokens can be obtained on request by contacting support@smart11.ai

Token Security

  • Tokens are shown only once at creation
  • Store tokens securely (environment variables, secrets manager)
  • Never commit tokens to version control
  • Rotate tokens periodically

Using the Token

Include the token in the Authorization header:

curl -X GET "https://aiontheball.nl/api/v1/analyses/123/summary" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

JavaScript/Fetch

const response = await fetch('https://aiontheball.nl/api/v1/analyses/123/summary', {
  headers: {
    'Authorization': `Bearer ${API_TOKEN}`,
    'Accept': 'application/json'
  }
});

Python/Requests

import requests

response = requests.get(
    'https://aiontheball.nl/api/v1/analyses/123/summary',
    headers={
        'Authorization': f'Bearer {API_TOKEN}',
        'Accept': 'application/json'
    }
)

Error Responses

Status Description
401 Missing or invalid token
403 Token valid but insufficient permissions 
{
  "message": "Unauthenticated."
}

Token Permissions

Tokens inherit permissions from your user account. You can only access analyses belonging to your organization.