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_insegundos (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.