Introducción
Esta documentación contiene la información necesaria para desarrollar sus propias aplicaciones integradas con Wialon.
Para las solicitudes solo se utiliza el método POST. Los parámetros adicionales (params) se envían y devuelven como JSON. Para todos los parámetros de texto se debe utilizar la codificación UTF-8.
Se recomienda utilizar el formato DEC ya que HEX solo es compatible como formato de texto.
Para Wialon Hosting, se utiliza el host https://hst-api.ibs-a.ru/ en las solicitudes (https://hst-api.wialon.us, https://hst-api.ibs-a.ru, https://hst-api.wialon.group, según el centro de datos); para Wialon Local — la URL del sitio de rastreo.
Plantilla de solicitud
La plantilla de cada solicitud debe ser la siguiente:
https://{host}/wialon/ajax.html?sid=<text>&svc=<svc>¶ms={<params>}
Es necesario indicar Content-Type:application/x-www-form-urlencoded en el encabezado de la solicitud.
Parámetros
Los siguientes parámetros deben utilizarse en una solicitud:
| Nombre | Descripción |
|---|---|
sid |
El ID único de la sesión. |
svc |
El nombre de la solicitud. |
params |
Los parámetros para la ejecución de la solicitud. |
En las páginas que siguen se describen solo los valores de dos parámetros: svc y params.
El identificador de sesión (
sid) es un parámetro obligatorio para todas las solicitudes. Las excepciones son las solicitudes de la sección token/login y algunas solicitudes de la sección Otros métodos.
Si no hay solicitudes en ejecución, la duración predeterminada de la sesión es de 5 minutos. Para mantener la sesión, debe utilizar el envío constante de la solicitud avl_evts, por ejemplo, cada 2 segundos.
Todos los números, incluidas las marcas, deben estar en sistema decimal.