post https://rest.inalambria.com/token
Este endpoint permite obtener un token de acceso, necesario para consumir los demás endpoints del API. La autenticación se realiza utilizando Basic Authentication enviando las credenciales del usuario (nombre de usuario y contraseña) en la cabecera de la solicitud.
{
"grant_type": "password"
}Reglas y Requisitos
- Cantidad de tokens activos por cliente: Por defecto 1. Si se requiere una cantidad mayor, es posible solicitarlos previamente. Al solicitar un nuevo token se valida la cantidad de tokens que tiene permitido la cuenta, expirando los tokens más antiguos. Si la cuenta solo maneja un token, al solicitar uno nuevo expira el token solicitado anteriormente y se crea un nuevo token.
- Tiempo de vida del token: Por defecto 4 horas; si se necesita un tiempo de expiración diferente, es posible solicitarlo previamente.
Posibles Estados HTTP de Respuesta
- 200: Token generado de manera exitosa.
- 400: Estructura de payload inválida.
- 401: No autorizado. Es necesario verificar las credenciales de autenticación.
- 403: Permisos insuficientes. Es posible que las credenciales estén validas, pero no se tiene permitido acceder al recurso (por ejemplo, la petición de consumo se genera desde una dirección IP no permitida).
- 500: Error interno del servidor. Se recomienda intentar en unos minutos, o en su defecto, contactar el servicio de soporte de Inalambria Internacional.
Campos de Respuesta
En la respuesta obtenida al consumir nuestro servicio, se encuentran los siguientes campos:
| Nombre | Descripción | Tipo de Dato |
|---|---|---|
| access_token | Token de acceso con el que es posible consumir los diferentes endpoints de nuestro API REST. | Texto |
| expires_in | Tiempo en segundos en que expirará el token generado. | Númerico |
| refresh_token | Token para usar al momento de solicitar la renovación del token actual, con el fin de no solicitar un nuevo token. | Texto |
| token_type | Tipo del token generado. | Texto |