... | ... | @@ -31,7 +31,7 @@ versión 1 obtendremos la siguiente URL: |
|
|
|
|
|
- Si la autentificación es válida, se obtiene una respuesta con la fecha y hora en la que se ha generado, en la que expira y el propio token.
|
|
|
|
|
|
```
|
|
|
```json
|
|
|
{
|
|
|
"issuedAt": "2021-04-01T09:09:16.284",
|
|
|
"expiration": "2021-04-02T09:09:16.284",
|
... | ... | @@ -41,7 +41,7 @@ versión 1 obtendremos la siguiente URL: |
|
|
|
|
|
- Además, si se realiza una petición con un token expirado se recibe un error **HTTP 400 – Bad Request** con la respuesta como en el siguiente ejemplo. Se debe solicitar un nuevo token para continuar realizando peticiones a la API.
|
|
|
|
|
|
```
|
|
|
```json
|
|
|
{
|
|
|
"status": 400,
|
|
|
"code": 6,
|
... | ... | @@ -51,7 +51,7 @@ versión 1 obtendremos la siguiente URL: |
|
|
|
|
|
- Para realizar peticiones a los *endpoints* de la API se debe adjuntar en las cabeceras de la petición un atributo en la cabecera (**Authorization**) y su valor será Bearer (el tipo de token obtenido) más el valor del token que has obtenido separado por un espacio. Por ejemplo:
|
|
|
|
|
|
```
|
|
|
```json
|
|
|
Bearer eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOiJDTW9iaWxpdHkzLjAiLCJzdWIiOiJwcnVlYmEiLCJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwiaWF0IoxNjE2NDIxMDYyLCJleHAiOjE2MTY0MjQ2NjJ9.N8KimN9_IgtjXX2Wv-rXLKK929mavlkaakxY_NzHVFgN9DWT8bqRVeTaBgL5GbzDfZSPZXDutoVwjdbTEx3FbA
|
|
|
```
|
|
|
|
... | ... | @@ -61,7 +61,7 @@ versión 1 obtendremos la siguiente URL: |
|
|
|
|
|
Como se ha indicado anteriormente, todas las respuestas HTTP que no sean **200 – OK**, se pueden considerar **inválidas**. El formato de la respuesta de error es como el siguiente ejemplo:
|
|
|
|
|
|
```
|
|
|
```json
|
|
|
{
|
|
|
"status": 401,
|
|
|
"code": 1,
|
... | ... | @@ -96,6 +96,16 @@ Estos errores tendrán tres categorías principales: |
|
|
| 9 | Required request body is missing |
|
|
|
| 10 | Event is marked as expired by timestamp |
|
|
|
|
|
|
En el caso de obtener un error *3 - Missing required property* la respuesta obtenida tendrá un valor en el message que nos indicará los campos que faltan por enviar:
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"status": 400,
|
|
|
"code": 3,
|
|
|
"message": "[deviceTypeId: must not be null, deviceUseTypeId: must not be null, informationQualityId: must not be null]"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
#### Error de Servidor
|
|
|
|
|
|
- HTTP Status: **500 - Internal Server Error**
|
... | ... | |