import_messages
Для импорта сообщений из файла используйте методexchange/import_messages.
svc=exchange/import_messages¶ms={
"itemId": <long>,
"eventHash": <text>
}
Этот запрос нельзя выполнить одновременно в другими запросами из этого раздела, а также со следующими запросами:
- …/report/exec_report,
- …/report/export_result,
- …/report/get_result_chart,
- …/report/get_result_map,
- …/messages/load_interval,
- …/render/create_messages_layer,
- …/unit/get_trips,
- …/resource/get_driver_bindings,
- …/resource/get_trailer_bindings,
- …/account/get_account_history.
Параметры
Обязательный параметр отмечен звездочкой (*).
| Параметр | Описание |
|---|---|
| itemId* | ID элемента. |
| eventHash | Имя события, которое будет сгенерировано после импорта сообщений. |
| dontMarkImported | Если этот параметр имеет значение 1, импортированные сообщения будут отмечаться не как импортированные (imported), а как сообщения из черного ящика (blackbox); время регистрации может отличаться от времени сообщения. Если этот параметр отсутствует или имеет значение, отличное от 1, сообщения будут помечены как импортированные (imported). |
Загрузка файла
Чтобы загрузить файл, используйте POST-запрос с множественным содержимым (multipart/form-data). Например:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_messages&sid=8157df114c0e601f0f31091c3c2ac53d
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--
Возвращаемый результат
При успешном выполнении запроса возвращается пустая строка.
{ }
Чтобы убедиться, что сообщения были импортированы, используйте метод avl_evts.
{
"tm": <uint>, /* текущее время сервера (UTC) */
"events": [
{
"i": -1,
"d": { /* данные */
"hash": <text>, /* загрузка завершена */
"msgCount": <text> /* количество импортированных сообщений */
}
}
]
}
Если запрос выполнить не удалось, возвращается код ошибки.
Коды ошибок
| Код | Описание |
|---|---|
| 1 | Неверный или устаревший SID запроса. |
| 4 | Нет прикрепленных файлов. |
| 6 | Внутренняя ошибка. |
| 7 | Одна из следующих ошибок:
|