import_messages
Para importar mensajes de un archivo, use el método exchange/import_messages.
Endpoint
svc=exchange/import_messages¶ms={
"itemId": <long>,
"eventHash": <text>
}
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.
Parámetros
El parámetro obligatorio está marcado con un asterisco (*).
| Parámetro | Descripción |
|---|---|
itemId* |
ID del elemento. |
eventHash |
Nombre del evento que se genera después de importar los mensajes. |
dontMarkImported |
Si este parámetro tiene el valor 1, los mensajes importados no se marcan como imported, sino como blackbox; la hora de registro puede diferir de la hora del mensaje. Si este parámetro no se pasa o tiene un valor distinto de 1, los mensajes se marcan como imported. |
Carga de un archivo
Para cargar un archivo, use una solicitud POST con contenido múltiple (multipart/form-data). Por ejemplo:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_messages&sid=SESSION_IDENTIFIER
Request Method: POST
Connection: keep-alive
Content-Length: 2744
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarylvunQiir9AesO8qB
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Charset: windows-1251,utf-8;q=0.7,*;q=0.3
Accept-Encoding: gzip,deflate,sdch
Accept-Language: ru,en-US;q=0.8,en;q=0.6
------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="params"
{"itemId":898446,"eventHash":"jUploadForm1372773585167"}
------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="eventHash"
jUploadForm1372773585167
------WebKitFormBoundarylvunQiir9AesO8qB
Content-Disposition: form-data; name="messages_filter_import_file"; filename="4100.zip"
Content-Type: application/zip
------WebKitFormBoundarylvunQiir9AesO8qB--
Respuesta
Si la solicitud se completa correctamente, se devuelve una respuesta vacía.
{ }
Para asegurarse de que los mensajes se hayan importado, puede ejecutar el método avl_evts.
{
"tm": <uint>, /* hora actual del servidor (UTC) */
"events": [
{
"i": -1,
"d": { /* datos */
"hash": <text>, /* carga completa */
"msgCount": <text> /* cantidad de mensajes importados */
}
}
]
}
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 1 | SID de solicitud no válido u obsoleto. |
| 4 | No se adjuntó ningún archivo. |
| 6 | Error interno. |
| 7 | Uno de los siguientes errores:
|