... | ... | @@ -6,43 +6,43 @@ |
|
|
|
|
|
- ~~Por motivos de seguridad, las conexiones serán nube a nube. La petición será realizada desde la nube de la empresa integradora y nunca desde los dispositivos directamente.~~
|
|
|
|
|
|
- DGT 3.0 facilitará un certificado y añadirá la IP pública del servidor desde donde se realizarán las peticiones a una lista blanca.
|
|
|
- ~~DGT 3.0 facilitará un certificado y añadirá la IP pública del servidor desde donde se realizarán las peticiones a una lista blanca.~~
|
|
|
|
|
|
- Una vez obtenido lo anterior, se configurará un cliente en cualquier tipo de lenguaje o plataforma que sea capaz de realizar peticiones API REST (como por ejemplo Postman).
|
|
|
- ~~Una vez obtenido lo anterior, se configurará un cliente en cualquier tipo de lenguaje o plataforma que sea capaz de realizar peticiones API REST (como por ejemplo Postman).~~
|
|
|
|
|
|
## API REST
|
|
|
## ~~API REST~~
|
|
|
|
|
|
La API REST está alojada en el siguiente dominio:
|
|
|
~~La API REST está alojada en el siguiente dominio:~~
|
|
|
|
|
|
> https://pre.cmobility30.es/bandejadesalida/
|
|
|
> ~~https://pre.cmobility30.es/bandejadesalida/~~
|
|
|
|
|
|
|
|
|
## Publicación desde la plataforma
|
|
|
## ~~Publicación desde la plataforma~~
|
|
|
|
|
|
Para **publicar** información la plataforma dispone una API REST que se utiliza según se describe a continuación
|
|
|
~~Para **publicar** información la plataforma dispone una API REST que se utiliza según se describe a continuación~~
|
|
|
|
|
|
### Identificación en el servicio
|
|
|
### ~~Identificación en el servicio~~
|
|
|
|
|
|
Para llevar a cabo las operaciones del API es necesario obtener un token de sesión que caducará de forma aleatoria a lo largo de la misma.
|
|
|
~~Para llevar a cabo las operaciones del API es necesario obtener un token de sesión que caducará de forma aleatoria a lo largo de la misma.~~
|
|
|
|
|
|
> [General · (cmobility30.es)](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/home)
|
|
|
> ~~[General · (cmobility30.es)](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/home)~~
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tablas maestras
|
|
|
## ~~Tablas maestras~~
|
|
|
|
|
|
- Los detalles de las tablas maestras y datos que pueden componer el evento. La API pone a disposición de los usuarios una serie de *endpoints* con los datos que componen el evento principal:
|
|
|
- ~~Los detalles de las tablas maestras y datos que pueden componer el evento. La API pone a disposición de los usuarios una serie de *endpoints* con los datos que componen el evento principal:~~
|
|
|
|
|
|
- https://pre.cmobility30.es/bandejadesalida/v1/mastertables/categories
|
|
|
- ~~https://pre.cmobility30.es/bandejadesalida/v1/mastertables/categories~~
|
|
|
|
|
|
- https://pre.cmobility30.es/bandejadesalida/v1/mastertables/modes
|
|
|
- ~~https://pre.cmobility30.es/bandejadesalida/v1/mastertables/modes~~
|
|
|
|
|
|
- https://pre.cmobility30.es/bandejadesalida/v1/mastertables/geomtypes
|
|
|
- ~~https://pre.cmobility30.es/bandejadesalida/v1/mastertables/geomtypes~~
|
|
|
|
|
|
- https://pre.cmobility30.es/bandejadesalida/v1/mastertables/direction
|
|
|
- ~~https://pre.cmobility30.es/bandejadesalida/v1/mastertables/direction~~
|
|
|
|
|
|
El formato será:
|
|
|
~~El formato será:~~
|
|
|
|
|
|
```json
|
|
|
{
|
... | ... | @@ -57,15 +57,15 @@ El formato será: |
|
|
}
|
|
|
```
|
|
|
|
|
|
## Obtener eventos
|
|
|
## ~~Obtener eventos~~
|
|
|
|
|
|
En este *endpoint* se va a obtener toda la información publicada relativa a los casos de uso 1 (señales bandejadesalida/v16), caso de uso 2 (obras e incidencias), caso de uso 4 (publicación por parte DGT Paneles de Mensaje Variables Virtuales) que se encuentren activas en cada momento y el balizamiento de pruebas deportivas del caso de uso 10 (el atributo pmvMsg tendrá el valor 'Restriccion por evento deportivo').
|
|
|
~~En este *endpoint* se va a obtener toda la información publicada relativa a los casos de uso 1 (señales bandejadesalida/v16), caso de uso 2 (obras e incidencias), caso de uso 4 (publicación por parte DGT Paneles de Mensaje Variables Virtuales) que se encuentren activas en cada momento y el balizamiento de pruebas deportivas del caso de uso 10 (el atributo pmvMsg tendrá el valor 'Restriccion por evento deportivo').~~
|
|
|
|
|
|
> https://pre.cmobility30.es/bandejadesalida/v1/events
|
|
|
> ~~https://pre.cmobility30.es/bandejadesalida/v1/events~~
|
|
|
|
|
|
Es un *endpoint* de tipo GET
|
|
|
~~Es un *endpoint* de tipo GET~~
|
|
|
|
|
|
Ejemplo de respuesta:
|
|
|
~~Ejemplo de respuesta:~~
|
|
|
|
|
|
```json
|
|
|
{
|
... | ... | @@ -94,35 +94,35 @@ Ejemplo de respuesta: |
|
|
]
|
|
|
}
|
|
|
```
|
|
|
El significado de los campos es el siguiente:
|
|
|
~~El significado de los campos es el siguiente:~~
|
|
|
|
|
|
Atributo | Descripción
|
|
|
~~Atributo~~ | ~~Descripción~~
|
|
|
--|--
|
|
|
pmvGeomWkt| Localización en formato WKT
|
|
|
pmvId| Identificador interno del evento
|
|
|
pmvMsg| Texto del mensaje
|
|
|
pmvImg| Identificación del icono correspondiente a la señal de tráfico
|
|
|
pmvType| Tipo de evento
|
|
|
pmvProv| Código INE de la provincia donde se produce el evento
|
|
|
pmvRoad| Etiqueta de la carretera donde se produce el evento
|
|
|
pmvPk| PK donde se produce el evento, si es puntual
|
|
|
pmvPkIni| PK inicial del evento si es un tramo
|
|
|
pmvPkFin| PK final del evento si es un tramo
|
|
|
pmvDirection| Dirección del kilometraje
|
|
|
pmvCategory| Categoría del evento
|
|
|
pmvMode| Modo del evento
|
|
|
pmvProvFin| Código INE de la provincia final donde se produce el evento en caso de tramos
|
|
|
pmvRoadFin| Etiqueta de la carretera final donde se produce el evento en caso de tramo
|
|
|
pmvEvent| Tipo de evento
|
|
|
gid| Identificador del evento en el sistema LINCE
|
|
|
~~pmvGeomWkt~~| ~~Localización en formato WKT~~
|
|
|
~~pmvId~~| ~~Identificador interno del evento~~
|
|
|
~~pmvMsg~~| ~~Texto del mensaje~~
|
|
|
~~pmvImg~~| ~~Identificación del icono correspondiente a la señal de tráfico~~
|
|
|
~~pmvType~~| ~~Tipo de evento~~
|
|
|
~~pmvProv~~| ~~Código INE de la provincia donde se produce el evento~~
|
|
|
~~pmvRoad~~| ~~Etiqueta de la carretera donde se produce el evento~~
|
|
|
~~pmvPk~~| ~~PK donde se produce el evento, si es puntual~~
|
|
|
~~pmvPkIni~~| ~~PK inicial del evento si es un tramo~~
|
|
|
~~pmvPkFin~~| ~~PK final del evento si es un tramo~~
|
|
|
~~pmvDirection~~| ~~Dirección del kilometraje~~
|
|
|
~~pmvCategory~~| ~~Categoría del evento~~
|
|
|
~~pmvMode~~| ~~Modo del evento~~
|
|
|
~~pmvProvFin~~| ~~Código INE de la provincia final donde se produce el evento en caso de tramos~~
|
|
|
~~pmvRoadFin~~| ~~Etiqueta de la carretera final donde se produce el evento en caso de tramo~~
|
|
|
~~pmvEvent~~| ~~Tipo de evento~~
|
|
|
~~gid~~| ~~Identificador del evento en el sistema LINCE~~
|
|
|
|
|
|
|
|
|
|
|
|
Se debe disponer del certificado para acceder.
|
|
|
~~Se debe disponer del certificado para acceder.~~
|
|
|
|
|
|
## NAP - DATEXII
|
|
|
## ~~NAP - DATEXII~~
|
|
|
|
|
|
Mediante la operación **GET** al *endpoint* **/bandejadesalida/v1/nap** es posible la obtención de todas los eventos que se publican en el *National Access Point* de España que tiene bajo su responsabilidad DGT. El conjunto de datos devueltos sigue el estándar DATEXII
|
|
|
~~Mediante la operación **GET** al *endpoint* **/bandejadesalida/v1/nap** es posible la obtención de todas los eventos que se publican en el *National Access Point* de España que tiene bajo su responsabilidad DGT. El conjunto de datos devueltos sigue el estándar DATEXII~~
|
|
|
|
|
|
```xml
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
... | ... | @@ -140,6 +140,6 @@ Mediante la operación **GET** al *endpoint* **/bandejadesalida/v1/nap** es posi |
|
|
</d2LogicalModel>
|
|
|
```
|
|
|
|
|
|
## SRT - DATEXII
|
|
|
## ~~SRT - DATEXII~~
|
|
|
|
|
|
Mediante la operación **GET** al *endpoint* **/bandejadesalida/v1/srtievents** es posible la obtención de todas los eventos que se publican en la Bandeja de Salida que no se publican en el *National Access Point* de España que tiene bajo su responsabilidad DGT. El conjunto de datos devueltos sigue el estándar DATEXII. Actualmente esos eventos son los relacionados con Coche detenido (V-16) y Vehículos de asistencia en carretera~~ |
|
|
\ No newline at end of file |
|
|
~~Mediante la operación **GET** al *endpoint* **/bandejadesalida/v1/srtievents** es posible la obtención de todas los eventos que se publican en la Bandeja de Salida que no se publican en el *National Access Point* de España que tiene bajo su responsabilidad DGT. El conjunto de datos devueltos sigue el estándar DATEXII. Actualmente esos eventos son los relacionados con Coche detenido (V-16) y Vehículos de asistencia en carretera~~ |
|
|
\ No newline at end of file |