put
Чтобы загрузить файлы в файловое хранилище, используйте метод file/put.
svc=file/put¶ms={
"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). Например:
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--
Ответ
В случае успешного выполнения запроса возвращается следующий ответ:
{
"error":0
}
В случае неудачного выполнения запроса возвращается код ошибки.
Коды ошибок
| Код | Описание |
|---|---|
| 1 | Пользователь не авторизован. |
| 4 | Неверные входные параметры. |
| 7 | Элемент, указанный в параметре itemId, не найден, указано недопустимое значение storageType или у вас нет прав доступа Просмотр и скачивание файлов и Загрузка и удаление файлов на элемент. |