BRIDGE API - REST – Autenticación: token
Este servicio permite consultar un JWT (Json Web Token) para poder consultar los métodos seguros de Bridge Api.
...
Descripción de los campos:
Campo | Tipo | Descripción | Requerido | Ejemplos |
clientId | String | Identificaro único del usuario que quiere acceder al servicio | SI | bridge-api |
clientSecret | String | Valor alfanumerico asociado al ClientId | SI |
Respuesta del servicio:
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"ack": 0,
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjEifQ.eyJpZCI6IjVlYjQzODgzNzYwNjM2MDNmOGFhOWM3MCIsImlhdCI6MTU5MzUzMTUxNywiZXhwIjoxNTkzNzA0MzE3LCJhdWQiOiJteWF1ZCIsImlzcyI6Im15aXNzdWVyIiwic3ViIjoiY2xpZW50IiwianRpIjoiMSJ9.ghrJlsem6HRo1X_nKfN85NPqy3duRsA5_l8Peiqm5HU",
} |
...
Una vez que se obtuvo el token, este se debe enviar en el HEADER de para ser evaluado por el servicio.
- Se envía de la siguiente manera: https://[direccion_ip]:[puerto]/auth/me - Ejemplo: https://localhost:8090/auth/me
- Se invoca via POST.
- El token se debe enviar en el header (cabecera) con el nombre x-access-token
...
Ejemplo de request con CURL
|
Códigos de error generales:
| ACK | Descripción | HTTP |
|---|---|---|
0 | La operación es exitosa. | 200 |
899 | Error al autentificarse. ClientId o ClienteSecret no son correctos. | 500 |
898 | Error desconocido solicitando el Token. Puede ser que el token enviado este mal formado. | 500 |
897 | Token expirado | 500 |
896 | x-access-token es vacío o no se envió en el header. | 500 |
999 | Error desconocido | 500 |
...