Authentication - Traddal

Overview

All API requests require a Bearer token passed in the Authorization header:

Authorization: Bearer your-access-token-here

Getting an Access Token

Use the OAuth2 client credentials flow to obtain an access token.

curl -X POST https://api.traddal.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

const response = await fetch("https://api.traddal.com/oauth/token", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    grant_type: "client_credentials",
    client_id: "YOUR_CLIENT_ID",
    client_secret: "YOUR_CLIENT_SECRET",
  }),
});

const { access_token } = await response.json();

import requests

response = requests.post(
    "https://api.traddal.com/oauth/token",
    data={
        "grant_type": "client_credentials",
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET",
    },
)

access_token = response.json()["access_token"]

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Using the Token

Include the token in all subsequent API requests:

curl -X POST https://api.traddal.com/v1/classify \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"description": "wireless bluetooth headphones", "destination_country": "us", "mode": "pro"}'

Tokens expire after the duration specified in expires_in (in seconds). Request a new token when the current one expires.