home

El caso de uso 12 está dedicado a la información relativa a la protección en tiempo real de obreros que realizan actuaciones de conservación en las carreteras. Este servicio incluye la información generada por los Conos Conectados

Recepción y publicación de datos relativos al posicionamiento en tiempo real de:

• Operarios de mantenimiento
• Vehículos de obras y mantenimiento que se encuentran en las vías

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 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 muestran las URLs con las que se accede a la funcionalidad:

Modo	URL	Descripción
Publicación	https://pre.cmobility30.es/use-case-12	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:

General · (cmobility30.es)

• Los detalles de las tablas maestras y datos que pueden componer el evento:

Tablas Maestras

• Información relativa al evento que se debe enviar:

Evento

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"
}

*Esto no aplica para el Caso de Uso 9 - Grúas.

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	Cone use type must be Infraestructure
  15	Cone vehicle type must be None
  16	Cone beacon type must be Unique

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": "[deviceTypeId: must not be null, deviceUseTypeId: must not be null, informationQualityId: must not be null]"
}

Error de Servidor

• HTTP Status: 500 - Internal Server Error

  Code	Message
  17	Internal error