Pular para o conteúdo

Autenticação (Token)

POST {base_url}/connect/token

Gerar um Bearer JWT que autoriza todas as chamadas seguintes. Usa o fluxo OAuth 2.0 client_credentials.

Header Valor
Content-Type application/x-www-form-urlencoded
Accept-Encoding gzip, deflate, br
Parâmetro Obrigatório Valor
client_id Sim Fornecido pela PT
client_secret Sim Fornecido pela PT
grant_type Sim client_credentials
scopes Sim admin_api
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"expires_in": 3600,
"token_type": "Bearer",
"scope": "admin_api"
}

Adicione a todas as demais requisições:

Authorization: Bearer <access_token>
Código HTTP Mensagem Causa / Solução
1003 400 invalid_client As credenciais foram rejeitadas. A resposta é a mesma seja porque o id ou o secret estão incorretos, seja porque as credenciais não estão ativas. Se as suas estiverem corretas, entre em contato com a PriceTravel: a resposta não distingue entre os casos.
1004 400 invalid_client_id_for_env_<environment> Usar credenciais de Integration em Production ou vice-versa
1005 400 invalid_client_secret Secret incorreto — verifique se não foi rotacionado
900 401 The authorization header is invalid Falta o prefixo Bearer ou o header está malformado
902 401 The authorization token is invalid Token corrompido ou assinado por outro tenant
903 401 The authorization token has expired O TTL do token expirou — gere um novo
1001 401 No authorization token provided O header Authorization não foi enviado
1003 401 The channel id <X> is not enabled to be used in <env> O channel existe mas não está provisionado neste ambiente. É retornado pelos endpoints chamados depois do token, não pelo token em si. O token pode ser emitido e essas chamadas ainda assim falhar.
  • invalid_client não indica qual das três causas se aplica. Se suas credenciais estiverem corretas e não tiverem mudado, entre em contato com a PriceTravel: a verificação acontece do lado da PriceTravel e não pode ser resolvida a partir da integração.
  • Credenciais emitidas para um ambiente não são válidas em outro.
  • Se você consegue obter um token mas as chamadas seguintes retornam 401 → verifique o prefixo Bearer, espaços em branco, encoding.
  • Se o token funciona para alguns endpoints mas não para outros → verifique o scope; apenas admin_api é suportado.
  • Os tokens expiram após expires_in segundos (tipicamente 1 hora).
  • Faça cache do token; não solicite um novo a cada chamada.
  • Renove proativamente a ~80% do TTL para evitar falhas na borda da expiração.