Saltar a contenido

Autenticación

Todos los métodos del API requieren un token de acceso. Se pide con sus credenciales y se envía en el encabezado Authorization de cada petición.

URL

POST https://ocelot.servientrega.us/connect/token
POST https://ocelotkiwi.azurewebsites.net/connect/token

Parámetros

Se envían como formulario (Content-Type: application/x-www-form-urlencoded), no como JSON.

Nombre Obligatorio Valor
client_id Sí Lo entrega Servientrega USA
client_secret Sí Lo entrega Servientrega USA
grant_type Sí Siempre password
username Sí Su usuario de Kiwi (el correo que se le asignó)
password Sí Su contraseña de Kiwi

Ejemplo de petición

curl -X POST "https://ocelot.servientrega.us/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "client_id=<YOUR_CLIENT_ID>" \
  --data-urlencode "client_secret=<YOUR_CLIENT_SECRET>" \
  --data-urlencode "grant_type=password" \
  --data-urlencode "username=<YOUR_USERNAME>" \
  --data-urlencode "password=<YOUR_PASSWORD>"
curl -X POST "https://ocelotkiwi.azurewebsites.net/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "client_id=<YOUR_CLIENT_ID>" \
  --data-urlencode "client_secret=<YOUR_CLIENT_SECRET>" \
  --data-urlencode "grant_type=password" \
  --data-urlencode "username=<YOUR_USERNAME>" \
  --data-urlencode "password=<YOUR_PASSWORD>"

Ejemplo de respuesta

{
  "access_token": "<ACCESS_TOKEN>",
  "expires_in": 14400,
  "token_type": "Bearer"
}

Uso del token

Envíe el token en el encabezado Authorization de todas las peticiones:

Authorization: Bearer <ACCESS_TOKEN>

Notas

  • Pruebas y Producción tienen credenciales distintas. Para pedir las de pruebas, escriba a developers@servientrega.us.
  • El token es válido durante expires_in segundos (hoy 14400 segundos, 4 horas). Lea ese valor de la respuesta en lugar de fijar el tiempo en su código: puede cambiar.
  • Cuando el token vence, el API responde 401 Unauthorized. Pida un token nuevo y repita la petición.
  • Use el mismo token mientras esté vigente. No pida un token nuevo en cada llamada.
  • Por seguridad, las credenciales vencen si no se usan durante un tiempo. Si sus credenciales dejan de funcionar, escriba a developers@servientrega.us.
  • Mantenga en reserva sus credenciales y tokens. No los incluya en páginas web, aplicaciones móviles ni repositorios de código.