POST /v2/oauth/token

Visão geral

Emite um access_token de curta duração para usar nas demais rotas v2.

URL: POST https://seu-dominio.com/v2/oauth/token

Codifique em Base64 o par public_id:secret (mesmos valores da chave de API):

Authorization: Basic {base64(public_id:secret)}
Accept: application/json

No cliente HTTP, “usuário” = public_id, “senha” = secret.

{
  "grant_type": "client_credentials",
  "public_id": "SEU_PUBLIC_ID",
  "secret": "SEU_SECRET"
}

{
  "grant_type": "client_credentials",
  "client_id": "SEU_PUBLIC_ID",
  "client_secret": "SEU_SECRET"
}

(client_id / client_secret são os mesmos valores que public_id / secret.)

{
  "access_token": "string-opaca",
  "token_type": "Bearer",
  "expires_in": 3600
}

O TTL padrão é configurável no backend (veja .env.example).

HTTP	Corpo (exemplo)
401	`{ "statusCode": 401, "message": "Unauthorized" }`
403	`{ "statusCode": 403, "message": "..." }` (KYC, ban, etc.)

curl -s -X POST "https://seu-dominio.com/v2/oauth/token" \
  -u "SEU_PUBLIC_ID:SEU_SECRET" \
  -H "Accept: application/json"