|
|
|
ru:sidebar:remoteapi:apiref:unit:upload_image [02/07/2013 12:51]
zuve |
ru:sidebar:remoteapi:apiref:unit:upload_image [29/11/2013 13:31]
|
| ====== Загрузка изображения объекта ====== | |
| Для того, чтобы загрузить изображение для объекта, нужно использовать команду **unit/upload_image**: | |
| <code javascript> | |
| svc=unit/upload_image¶ms={"itemId":<long>, | |
| "eventHash":<text>} | |
| </code> | |
| ===== Параметры ===== | |
| ^ Название ^ Описание ^ | |
| | itemId | ID объекта | | |
| | eventHash | имя события, которое будет сгенерировано после загрузки изображения (необязательный параметр) | | |
| |
| Чтобы загрузить изображение, используйте POST запрос с несколькими параметрами (multipart/form-data), например: | |
| |
| |
| <code> | |
| Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=unit/upload_image&sid=8157df114c0e601f0f31091c3c2ac53d | |
| 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-- | |
| </code> | |
| |
| ===== Возвращаемый результат ===== | |
| <code=javascript> | |
| {} /* пустой объект при удачном выполнении, при неудачном - код ошибки */ | |
| </code> | |
| |
| Чтобы получить информацию о том, что изображение загружено, следует выполнить команду [[../requests/avl_evts|Другие запросы: События]]: | |
| |
| <code=javascript> | |
| { | |
| "tm":<uint>, /* текущее время сервера (UTC) */ | |
| "events":[ | |
| { | |
| "i":<long>, /* ID объекта (-1 - неизвестно) */ | |
| "d":{ /* данные */ | |
| "hash":"UploadUnitImage" /* загрузка завершена */ | |
| } | |
| } | |
| ] | |
| } | |
| </code> | |
