convert_file

Для конвертации файлов в формате XLSX и CSV в формат JSON, используйте метод exchange/convert_file:

Copied!
svc=exchange/convert_file&params={"format":"csv", "separator":","}

Максимальный размер файла для конвертации — 64 Мбайт.

Параметры

Обязательные параметры отмечены звездочкой (*).

ПараметрОписание
format*Формат файла. Поддерживаемые форматы: XLSX, CSV.
separator*Разделитель. Только для формата CSV.
eventHashИмя события, которое будет сгенерировано после прочтения данных.

Чтобы загрузить файл, используйте POST-запрос с несколькими параметрами (multipart/form-data). В form-data необходимо сделать отдельный параметр типа file и указать имя файла. Например, в Postman это можно сделать в query params.

Пример запроса:

Copied!
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, чтобы увидеть результат.

Пример возвращаемого результата:

Copied!
{

      "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Нет доступа. 
Скачать файл PDF
Скачать документ Word

Смотрите также

  • check\_items\_billing Руководство пользователя
  • write Руководство пользователя
  • exchange Руководство пользователя