curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "rcs_a1b2c3d4e5f67890",
"client_secret": "seu-secret-aqui"
}'
curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "refresh_token",
"refresh_token": "seu-refresh-token"
}'
{
"access_token": "<string>",
"token_type": "<string>",
"expires_in": 123,
"refresh_token": "<string>",
"scope": "<string>"
}Referência da API
POST /oauth/token
Obtém access token via client credentials ou refresh token
POST
/
api
/
v1
/
oauth
/
token
curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "rcs_a1b2c3d4e5f67890",
"client_secret": "seu-secret-aqui"
}'
curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "refresh_token",
"refresh_token": "seu-refresh-token"
}'
{
"access_token": "<string>",
"token_type": "<string>",
"expires_in": 123,
"refresh_token": "<string>",
"scope": "<string>"
}Request Body
string
required
Tipo de autenticação. Valores aceitos:
client_credentials ou refresh_token.string
ID do cliente OAuth. Obrigatório quando
grant_type=client_credentials.string
Secret do cliente OAuth. Obrigatório quando
grant_type=client_credentials.string
Refresh token válido. Obrigatório quando
grant_type=refresh_token.Resposta de Sucesso (200)
{
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "a1b2c3d4e5f6789...",
"scope": "campaigns:dispatch"
}
string
JWT token para autenticar nas requisições da API. Válido por 1 hora.
string
Sempre
"Bearer".number
Tempo de expiração em segundos (3600 = 1 hora).
string
Token para renovar o access token sem re-autenticar. Válido por 30 dias. Uso único (rotation).
string
Permissões concedidas ao token.
Erros
| Status | Descrição |
|---|---|
| 400 | Parâmetros inválidos ou ausentes |
| 401 | Credenciais inválidas ou refresh token expirado/revogado |
| 429 | Rate limit excedido (10 req/min) |
curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "rcs_a1b2c3d4e5f67890",
"client_secret": "seu-secret-aqui"
}'
curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "refresh_token",
"refresh_token": "seu-refresh-token"
}'