Introducción
Esta documentación contiene información necesaria para desarrollar sus propias aplicaciones basadas en Wialon.
Para solicitudes se utiliza solo el método POST. Los parámetros adicionales (params) se envían y se devuelven como JSON. Para todos los parámetros de texto debe devolverse la codificación UTF-8.
Se recomienda usar el formato DEC, dado que HEX solo se soporta como un formato de texto.
Para Wialon Hosting, en solicitudes se utiliza host http://hst-api.wialon.com/ (http://hst-api.wialon.us/, http://hst-api.wialon.ru/, dependiendo del centro de datos); para Wialon Local, URL del sitio de seguimiento.
Plantilla de solicitud
La plantilla de cada solicitud debe ser la siguiente:
http://{host}/wialon/ajax.html?sid=<text>&svc=<svc>¶ms={<params>}
En el título de la solicitud es necesario indicar Content-Type:application/x-www-form-urlencoded.
Parámetros
En una solicitud deben utilizarse los siguientes parámetros:
| Nombre | Descripción |
|---|---|
| sid | Identificador único de la sesión. |
| svc | Nombre de la solicitud. |
| params | Parámetros para ejecución de la solicitud. |
En las páginas que siguen se describen solo los valores de dos parámetros: svc y params.
Al ejecutarse todas las solicitudes, el identificador de la sesión (sid) es un parámetro obligatorio. La excepción son solicitudes de la sección Inicio de sesión con token y algunas solicitudes de la sección Otras solicitudes.
La duración de una sesión por defecto, si no hay solicitudes que se ejecutan, es 5 minutos. Para mantener una sesión iniciada, utilice el envío constante de la solicitud avl_evts, por ejemplo, una vez cada dos segundos.
Todos los números deben ser en el sistema decimal, incluyendo, marcas.