... | ... | @@ -16,42 +16,13 @@ A continuación se muestran las URLs con las que se accede a cada funcionalidad: |
|
|
| ----------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
| Suscripción | https://pre.cmobility30.es/use-case-7 | Endpoint del entorno de integración para la suscripción |
|
|
|
|
|
|
## 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)](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/home)
|
|
|
|
|
|
- Información relativa a los métodos específicos del caso de uso:
|
|
|
|
|
|
> [Metodos de publicación](publicacion/Metodos)
|
|
|
|
|
|
- Información relativa al detalles de las tablas maestras:
|
|
|
|
|
|
> [Tablas maestras](publicacion/Tablas-Maestras)
|
|
|
|
|
|
## Suscripción
|
|
|
|
|
|
Este caso de uso tiene un comportamiento similar al que ofrece la interfa de bandeja de salida que puede encontrarse en el [caso de uso 4. Panel de mensajes virtual.](https://gitlab.cs.cmobility30.es/dgt3.0_esp/caso-de-uso-4) La API ofrece un endpoint a traves del cual se publica la información de velocidades recomendadas en las distintas carreteras y autovías. Dicho endpoint se muestra a continuación y se debe acceder a el realizando una petición de tipo _GET_. Así mismo, los detalles generales para realizar una petición se pueden encontrar en [General · (cmobility30.es)](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/home)
|
|
|
|
|
|
> {baseUrl}/v1/events
|
|
|
|
|
|
Este caso de uso también dispone de un servicio de suscripción (recepción) de datos por parte de las empresas que así lo deseen mediante el protocolo MQTT. Este caso de uso es solo para **los servicios de seguimiento de las pruebas o eventos deportivos**, si se desea la suscripción a la información de eventos de conos (cortes de carretera) se debe hacer a través de la interfaz de bandeja de salida que puede encontrarse en el [caso de uso 4. Panel de mensajes virtual.](https://gitlab.cs.cmobility30.es/dgt3.0_esp/caso-de-uso-4)
|
|
|
|
|
|
|
|
|
A continuación se pueden encontrar los detalles de la suscripción MQTT para este caso de uso 10 (Eventos deportivos):
|
|
|
|
|
|
**MQTT (MQ Telemetry Transport)** es un protocolo de mensajería que se usa como un método simple y liviano para transferir datos hacia/desde dispositivos de baja potencia. Puede ver más información y un ejemplo de conexión [aquí](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/MQTT).
|
|
|
|
|
|
El protocolo admite un único patrón de mensajería, el patrón **Publicar-Suscribir**: cada mensaje es publicado en un tópico al que se debe suscribir para recibir la información.
|
|
|
|
|
|
La suscripción al servicio de este caso de uso deberá ser mediante el tópico:
|
|
|
|
|
|
> usecase10/events
|
|
|
|
|
|
En el tópico se publican los eventos en formato JSON. Aquí se puede ver un ejemplo:
|
|
|
En el endpoint se publican las velocidades recomendadas en formato JSON. Aquí se puede ver un ejemplo:
|
|
|
|
|
|
```json
|
|
|
[
|
... | ... | |