convert_file
Для конвертации файлов в формате XLSX и CSV в формат JSON, используйте метод exchange/convert_file:
svc=exchange/convert_file¶ms={"format":"csv", "separator":","}
Максимальный размер файла для конвертации — 64 Мбайт.
Параметры
Обязательные параметры отмечены звездочкой (*).
Параметр | Описание |
---|---|
format* | Формат файла. Поддерживаемые форматы: XLSX, CSV. |
separator* | Разделитель. Только для формата CSV. |
eventHash | Имя события, которое будет сгенерировано после прочтения данных. |
Чтобы загрузить файл, используйте POST-запрос с несколькими параметрами (multipart/form-data). В form-data необходимо сделать отдельный параметр типа file и указать имя файла. Например, в Postman это можно сделать в query params.
Пример запроса:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/convert_file&sid=8157df114c0e601f0f31091c3c2ac53d
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"
jUploadForm1372772377019
------WebKitFormBoundaryhAXcAjtvh1D61XpC
Content-Disposition: form-data; name="import_file"; filename="file.zip"
Content-Type: application/zip
------WebKitFormBoundaryhAXcAjtvh1D61XpC--
Возвращаемый результат
При успешной конвертации возвращается результат в формате JSON. Если в запросе не было параметра eventHash, результат возвращается сразу. Если этот параметр содержался в запросе, необходимо выполнить команду avl_evts, чтобы увидеть результат.
Пример возвращаемого результата:
{
"filename": "test.xlsx",
"sheets": [
{
"rows": [
[
"№",
"Время",
"Пользователь",
"Тип элемента",
"Действие",
"Хост",
"Заметки"
],
[
"1",
"2023-09-13 10:45:15",
"maqsat",
"Ресурс",
"Ресурс 'Radares Maqsat' создан.",
"167.61.60.214",
" "
],
[
"2",
"2023-09-13 10:45:16",
"maqsat",
"Ресурс",
"Учетная запись 'Radares Maqsat' создана.",
"167.61.60.214",
" "
]
]
}
]
}
Если файл не удалось конвертировать, возвращается код ошибки.
Коды ошибок
Код | Описание |
---|---|
4 | Превышен максимальный допустимый размер файла, параметры запроса невалидны, или передан неизвестный формат. |
5 | Не удалось открыть или конвертировать файл. |
6 | Неизвестная ошибка. |
7 | Нет доступа. |