upload_image
Чтобы загрузить изображение для объекта, используйте метод unit/upload_image:
svc=unit/upload_image¶ms={
"itemId": <long>,
"eventHash": <text>
}
Параметры
Запрос может содержать следующие параметры. Обязательные параметры отмечены звездочкой (*).
| Параметр | Описание |
|---|---|
itemId* |
ID объекта. |
eventHash |
Название события, которое генерируется после загрузки изображения. |
Загрузка изображения
Чтобы загрузить изображение, используйте POST-запрос с составным содержимым (multipart/form-data), в котором одна часть содержит параметры, а другая — изображение. Например:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=unit/upload_image&sid=SESSION_IDENTIFIER
Request Method: POST
Host: hst-api.wialon.com
Connection: keep-alive
Content-Length: 31720
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryECovXn5tfw5muHk8
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
------WebKitFormBoundaryECovXn5tfw5muHk8
Content-Disposition: form-data; name="params"
{"itemId":911903,"eventHash":"jUploadForm1372769354768"}
------WebKitFormBoundaryECovXn5tfw5muHk8
Content-Disposition: form-data; name="eventHash"
jUploadForm1372769354768
------WebKitFormBoundaryECovXn5tfw5muHk8
Content-Disposition: form-data; name="icon_file"; filename="image.jpg"
Content-Type: image/jpeg
------WebKitFormBoundaryECovXn5tfw5muHk8--
Ответ
При успешном выполнении запроса возвращается пустой объект:
{}
Чтобы убедиться, что изображение загружено, используйте метод requests/avl_evts.
Если запрос выполнить не удалось, возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры. |
| 6 | Не удалось сохранить изображение. |
| 7 | Объект не существует, или у пользователя нет права доступа Изменение иконки на него. |