Caso de Uso 17
El caso de uso 17 está dedicado a la información relativa a la recepción y publicación en tiempo real de la posición de los trabajadores en la carretera cuando estos presenten un riesgo para sí mismos o para los conductores. Este servicio incluye la información generada por los Chalecos Conectados
Esta información podrá ser enviada a la plataforma DGT 3.0 o bien por dispositivos de IoT o bien por Apps que se puedan utilizar para posicionar estos elementos en la vía. La plataforma cuenta con la funcionalidad para la publicación (envío) de información a través de una API REST. La funcionalidad de publicación requiere de certificados de acceso distintos que deben ser solicitados y suministrados por DGT 3.0. Estos certificados, de no haber sido solicitados ya, se deberán solicitar a soporte@cmobility30.es.
A continuación se muestra la URL con las que se accede a la funcionalidad:
Modo | URL | Descripción |
---|---|---|
Publicación | https://pre.cmobility30.es/use-case-17 | Endpoint del entorno de integración de clientes para la publicación |
A continuación se describe la funcionalidad.
Publicación
Este caso de uso dispone de una API REST para la publicación (envío) de los datos por parte de las empresas que así lo deseen. En los siguientes apartados se pueden encontrar los detalles de esta:
- Los detalles generales para realizar una petición:
- Los detalles de las tablas maestras y datos que pueden componer el evento:
- Información relativa al evento que se debe enviar:
Errores
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:
{
"status": 401,
"code": 1,
"message": "User not found or valid"
}
Estos errores tendrán tres categorías principales:
Error de Autentificación
- HTTP Status: 401 - Unauthorized
Code Message 1 User not found or valid
Error de Cliente
- HTTP Status: 400 - Bad Request
Code Message 0 Authenticate 2 Entity ID not found 3 Missing required property 4 The entity received cannot be proccessed 5 Incorrect token received 6 Expired token received 7 There is an error with the token provided. Please request a new one 8 No token received 9 Required request body is missing 10 Event is marked as expired by timestamp 11 Missing request header 12 Permission denied. Role assigned to user missing 13 There is an error in one or more elements of the list 14 The actionId must be unique. This one has been already used 15 The event type is 3. However, event has not been started 16 The event has already been marked as finished 17 The event has already been marked as started 19 The event had been marked as finished automatically 20 The event type must be between 2 and 3
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:
{
"status": 400,
"code": 3,
"message": "[beaconTypeId: must not be null, lon: must not be null]"
}
Error de Servidor
- HTTP Status: 500 - Internal Server Error
Code Message 17 Internal error