← Home
← Back to Home
API Documentation
Authentication Issue License Validate License Info

🔐 Authentication

All API requests require Bearer token authentication. Include your API token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Obtain your API token from the customer portal after subscribing.

📝 Issue License

POST /license/issue

Generate a new license token for a customer.

Request Body

email string (required)

Customer email address

plan string (required)

Plan type: STARTER, PRO, or BUSINESS

seats integer (required)

Number of license seats

allowed_domains array (optional)

Array of authorized domains

Example Request

curl -X POST https://trafficorchestrator.com/license/issue   -H "Authorization: Bearer YOUR_API_TOKEN"   -H "Content-Type: application/json"   -d '{
    "email": "customer@example.com",
    "plan": "PRO",
    "seats": 5,
    "allowed_domains": ["example.com", "app.example.com"]
  }'

Response

{
  "ok": true,
  "token": "a1b2c3d4e5f6...",
  "expires_at": "2026-10-16T00:00:00Z"
}

✅ Validate License

POST /license/validate

Validate a license token and domain combination.

Request Body

token string (required)

License token to validate

domain string (required)

Domain making the validation request

Example Request

curl -X POST https://trafficorchestrator.com/license/validate   -H "Content-Type: application/json"   -d '{
    "token": "a1b2c3d4e5f6...",
    "domain": "example.com"
  }'

Response

{
  "ok": true,
  "valid": true,
  "plan": "PRO",
  "expires_at": "2026-10-16T00:00:00Z"
}

📊 License Info

POST /license/info

Retrieve complete license information including authorized domains.

Request Body

token string (required)

License token to query

Example Request

curl -X POST https://trafficorchestrator.com/license/info   -H "Content-Type: application/json"   -d '{
    "token": "a1b2c3d4e5f6..."
  }'

Response

{
  "ok": true,
  "token": "a1b2c3d4e5f6...",
  "email": "customer@example.com",
  "plan": "PRO",
  "seats": 5,
  "expires_at": "2026-10-16T00:00:00Z",
  "domains": ["example.com", "app.example.com"]
}

⚡ Rate Limits

API requests are rate limited based on your plan:

🐛 Error Responses

All errors return a JSON response:

{
  "ok": false,
  "error": "Error message description"
}

Common HTTP status codes:

← Back to Home