Ir al contenido

Autenticación (Token)

POST {base_url}/connect/token

Generar un Bearer JWT que autoriza todas las llamadas posteriores. Usa el flujo OAuth 2.0 client_credentials.

Header Valor
Content-Type application/x-www-form-urlencoded
Accept-Encoding gzip, deflate, br
Parámetro Requerido Valor
client_id Sí Proporcionado por PT
client_secret Sí Proporcionado por PT
grant_type Sí client_credentials
scopes Sí admin_api
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"expires_in": 3600,
"token_type": "Bearer",
"scope": "admin_api"
}

Agrégalo a todas las demás peticiones:

Authorization: Bearer <access_token>
Código HTTP Mensaje Causa / Solución
1003 400 invalid_client Las credenciales fueron rechazadas. La respuesta es la misma tanto si el id como el secret son incorrectos, o si las credenciales no están activas. Si las tuyas son correctas, contacta a PriceTravel: la respuesta no distingue entre los casos.
1004 400 invalid_client_id_for_env_<environment> Usar credenciales de Integration en Production o viceversa
1005 400 invalid_client_secret Secret incorrecto — verifica que no haya sido rotado
900 401 The authorization header is invalid Falta el prefijo Bearer o el header está malformado
902 401 The authorization token is invalid Token corrupto o firmado por otro tenant
903 401 The authorization token has expired El TTL del token expiró — genera uno nuevo
1001 401 No authorization token provided No se envió el header Authorization
1003 401 The channel id <X> is not enabled to be used in <env> El channel existe pero no está provisionado en este entorno. Lo devuelven los endpoints que se llaman después del token, no el token en sí. El token puede emitirse correctamente y estas llamadas seguir fallando.
  • invalid_client no indica cuál de las tres causas aplica. Si tus credenciales son correctas y no han cambiado, contacta a PriceTravel: la verificación ocurre del lado de PriceTravel y no se puede resolver desde la integración.
  • Las credenciales emitidas para un entorno no son válidas en otro.
  • Si puedes obtener un token pero las llamadas siguientes devuelven 401 → revisa el prefijo Bearer, espacios en blanco, encoding.
  • Si el token funciona para algunos endpoints pero no para otros → revisa el scope; solo admin_api está soportado.
  • Los tokens expiran después de expires_in segundos (típicamente 1 hora).
  • Cachea el token; no solicites uno nuevo en cada llamada.
  • Renueva proactivamente al ~80% del TTL para evitar fallos al borde de la expiración.