Web Service Paquetes

A continuación se explica brevemente la interfaz del Servicio Web para el envío o retransmisión de Paquetes generados por los dispositivos reportando en la plataforma de Monitoreo, a sus clientes o empresas externas autorizadas.

Tecnología de integración

Para poder integrar el envío de Paquetes, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz ofrecemos se encuentra desarrollada bajo los estándares de RESTful según se describe en el presente documento.

Instrucciones de uso

Para utilizar este Web Service, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Paquetes":

Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para realizar las configuraciones de envío:

Se abrirá una ventana y debemos de elegir qué tipo de transmisión se va a ocupar para el envío de datos, TCP/UDP o API REST:

Configurar Recurso

Podemos seleccionar dos tipos de recursos para el envío de datos.

• API REST
• TCP/UDP

Acceso por API REST:

Para configurar el acceso por API REST debemos ingresar la url del Host, donde podemos indicar la URL hacia donde se enviará la información.

 

Acceso por TCP/UDP:

Deberá proporcionar los siguientes parámetros.

• Ip
• Puerto
• Protocolo: Debe especificar si usará TCP o UDP.

Asignación de clientes y sus activos para el reenvío de paquetes al recurso previamente configurado:

Descripción del reenvío

Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacenan sus paquetes crudos en la base de datos (BD), el Web Service Paquetes se encarga de obtener la información de los paquetes crudos de los equipos y la reenvía a la URL o IP que se haya configurado previamente, en cuanto se obtenga un paquete este es inmediatamente reenviado.

La descripción general se puede representar con el siguiente diagrama:

 

Estructura del Web Service

Se ha creado una estructura que utiliza JSON como entrega, dependiendo la configuración TCP/UDP o API REST.

 

Ejemplo del envío:

{

       "device":"345456577489456",
       "package":"2525A47121111JD124552525",
       "date":"2024-09-11",
       "time":11:48:02",
       "asset":"AA123",
       "plate":"SPP433"

}

Visualización del log para el envío de paquetes: