upload_file
Чтобы загрузить файлы и получить их содержимое в событии сессии, используйте метод unit/upload_file. Метод не сохраняет файлы ни в объекте, ни где-либо еще на сервере:
svc=unit/upload_file¶ms={
"eventHash": <text>,
"toHex": <uint>
}
Параметры
Все параметры необязательные. Обязателен сам файл: если запрос не содержит файла, возвращается код ошибки 4.
| Параметр | Описание |
|---|---|
| toHex | Использовать преобразование двоичных данных в строку: 0 — нет, 1 — да. |
| eventHash | Название события, которое генерируется в сессии после загрузки файлов. Событие содержит это название и содержимое каждого загруженного файла (в шестнадцатеричном формате, если toHex равен 1). Если параметр не указан, событие не генерируется. |
Загрузка файла
Чтобы загрузить файл, используйте POST-запрос с составным содержимым (multipart/form-data), в котором одна часть содержит параметры, а другая — файл. Например:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=unit/upload_file&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","toHex":1}
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="file"; filename="file.zip"
Content-Type: application/zip
------WebKitFormBoundaryhAXcAjtvh1D61XpC--
Ответ
При успешном выполнении запроса возвращается пустой объект:
{}
Чтобы убедиться, что файл загружен, используйте метод requests/avl_evts.
Если запрос выполнить не удалось, возвращается код ошибки 4, означающий, что запрос не содержит файла.