Introducción
Esta documentación contiene la información necesaria para desarrollar sus propias aplicaciones integradas con Wialon Hosting y Wialon Local.
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.wialon.com/ en las solicitudes (https://hst-api.wialon.us, https://hst-api.wialon.eu, https://hst-api.wialon.org, según el centro de datos); para Wialon Local — la URL del sitio de rastreo.
Otras soluciones en el ecosistema Wialon tienen sus propias API. Para obtener más información, consulte API para otras soluciones.
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.