import_json
Чтобы прочитать данные из файла в формате WLP, используйте метод exchange/import_json.
Конечная точка
svc=exchange/import_json¶ms={
"eventHash": <text>
}
Метод относится к ресурсоемким запросам, поэтому на него распространяется ограничение на количество одновременно обрабатываемых ресурсоемких запросов в одной сессии. При превышении ограничения возвращается ошибка 1003 с причиной
LIMIT api_concurrent. Список ресурсоемких запросов см. в разделе Ограничения.
Параметры
В запрос можно включить необязательный параметр eventHash. Он позволяет указать имя события, которое генерируется после чтения данных.
Загрузка файла
Чтобы загрузить файл в формате WLP, используйте запрос POST с множественным содержимым (multipart/form-data). Например:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_json&sid=SESSION_IDENTIFIER
Request Method: POST
Connection: keep-alive
Content-Length: 1901
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryhAXcAjtvh1D61XpC
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
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="params"
{"eventHash":"jUploadForm1372772377019"}
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="eventHash"
jUploadForm1372772377019
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="import_file"; filename="file.zip"
Content-Type: application/zip
------WebKitFormBoundaryhAXcAjtvh1D61XpC--
Ответ
При успешном выполнении запроса возвращается пустой ответ.
{ }
Чтобы убедиться, что данные были прочитаны, используйте метод avl_evts:
{
"tm": <uint>, /* текущее время сервера (UTC) */
"events": [
{
"i": -1,
"d": { /* данные */
"hash": <text>, /* загрузка завершена */
"files": { /* файлы загружены */
<text>: <Object>, /* имя файла: данные файла */
...
}
}
}
]
}
При неудачном выполнении возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 1 | Неверный или устаревший SID запроса. |
| 4 | Нет прикрепленных файлов. |
| 7 | Не удалось получить данные о текущем пользователе. |