Справочный центр Wialon

put

Чтобы загрузить файлы в файловое хранилище, используйте метод file/put.

Copied!
svc=file/put&params={
  "itemId": <long>,
  "storageType": <uint>,
  "path": <text>,
  "writeType": <uint>,
  "eventHash": <text>
  }
  &sid=<text>

Параметры

Параметр

Описание

itemId

ID элемента.

storageType

Тип хранилища:
1  общедоступное (все пользователи могут видеть и скачивать файлы),
2  закрытое (только пользователи с правами доступа могут видеть и скачивать файлы).

path

Относительный путь от корневой папки к файлу.

writeType

Тип записи:
0  перезаписать файл,
1  добавить в конец,
2  не записывать, если такой файл уже существует.

eventHash

Имя события, которое будет сгенерировано после прочтения данных.

Имена файла и папки не должны совпадать.

Чтобы загрузить несколько файлов, отправьте их с помощью POST-запроса с параметрами (multipart/form-data). Например:

Copied!
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=file/put
Request Method: POST
Connection: keep-alive
Content-Length:333998
Cache-Control:max-age=0
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryMpLUirMexsfCGaJP
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


------WebKitFormBoundaryhJ0ZukEcpN7MgFnC
Content-Disposition: form-data; name="params"

{"itemId":439,"storageType":"1","path":"1","writeType":0,"eventHash":"jUploadForm1414572405484"}
------WebKitFormBoundaryhJ0ZukEcpN7MgFnC
Content-Disposition: form-data; name="eventHash"

jUploadForm1414572405484
------WebKitFormBoundaryhJ0ZukEcpN7MgFnC
Content-Disposition: form-data; name="f"; filename="one-file"
Content-Type: application/octet-stream


------WebKitFormBoundaryhJ0ZukEcpN7MgFnC--

Возвращаемый результат

При успешном выполнении запроса возвращается следующий результат:

Copied!
{
  "error":0
}

Если запрос выполнить не удалось, возвращается код ошибки.

Коды ошибок

Код Описание
1 Пользователь не авторизован.
4 Невалидные входные параметры.
7 Недостаточно прав на элемент, указанный в параметре itemId.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.

Сообщить об ошибке

Ваше сообщение отправлено. Спасибо!

Произошла ошибка при отправке формы

Скачать файл PDF
Скачать документ Word

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

  • detach Руководство пользователя
  • list_virtual_order_routes Руководство пользователя
  • attach Руководство пользователя