multi_import

El método exchange/multi_import permite crear unidades a partir de un archivo ZIP e importar sus mensajes. Para crear este archivo, use el método exchange/multi_export.

Para utilizar el método, el servicio Importar/Exportar debe estar habilitado para la cuenta. Cada archivo WLP del archivo comprimido cuenta como un uso del servicio.

En Wialon Local, este método está disponible a partir de la versión 2304.

svc=exchange/multi_import&params={
  "userId": <uint>
}

El método es una solicitud que consume muchos recursos, por lo que se le aplica la restricción de solicitudes simultáneas de este tipo durante una sesión. Si se alcanza la restricción, se devuelve el error 1003 con la causa LIMIT api_concurrent. Para ver la lista de solicitudes que consumen muchos recursos, consulte Restricciones.

Para cargar el archivo comprimido, use una solicitud POST con contenido múltiple (multipart/form-data). Si se adjuntan varios archivos, solo se procesa el primero. Por ejemplo:

Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/multi_import&sid=SESSION_IDENTIFIER
Request Method: POST
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarylvunQiir9AesO8qB

------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="params"

{"userId":123456}
------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="file"; filename="multi_export.zip"
Content-Type: application/zip


------WebKitFormBoundarylvunQiir9AesO8qB--

El archivo comprimido debe contener los siguientes archivos:

Para cada archivo WLP del archivo comprimido, se crea una nueva unidad. Las unidades existentes no se actualizan. Las propiedades de la unidad del archivo se aplican a la nueva unidad.

El tipo de dispositivo se define por su ID o nombre del archivo. Si no se encuentra el tipo de dispositivo, se establece el tipo de dispositivo con ID 899 (Wialon Retranslator). Si el servidor no tiene un tipo de dispositivo con este ID, la unidad no se crea.

Los mensajes del archivo WLB se importan solo si el creador tiene el derecho de acceso Importar mensajes a la nueva unidad.

Si no se puede crear una unidad, se omite y no se devuelve ningún error.

Si la solicitud se completa correctamente, se devuelve la siguiente respuesta:

{
  "error": 0
}

Si la solicitud falla, se devuelve un código de error.