|
|
ru:sidebar:remoteapi:apiref:unit:upload_image [14/01/2013 13:50] 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> | |
POST /wialon/ajax.html?svc=resource/upload_image&sid=<long> HTTP/1.1 | |
Host: <host> | |
Connection: keep-alive | |
Content-Length: <uint> | |
Cache-Control: max-age=0 | |
Content-Type: multipart/form-data; boundary=----k2vvQ6nvlallm1lk | |
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 | |
Accept-Encoding: gzip,deflate,sdch | |
Accept-Language: ru-RU,ru;q=0.8,en-US;q=0.6,en;q=0.4 | |
Accept-Charset: windows-1251,utf-8;q=0.7,*;q=0.3 | |
| |
------k2vvQ6nvlallm1lk | |
Content-Disposition: form-data; name="params" | |
| |
{"itemId":<uint>,"eventHash":"UploadUnitImage"} | |
------k2vvQ6nvlallm1lk | |
Content-Disposition: form-data; name="upload_image"; filename="unit_image.jpg" | |
Content-Type: image/jpeg | |
| |
<binary data image> | |
------k2vvQ6nvlallm1lk-- | |
</code> | |
| |
===== Возвращаемый результат ===== | |
<code=javascript> | |
{} /* пустой объект при удачном выполнении, при неудачном - код ошибки */ | |
</code> | |
| |
Чтобы получить информацию о том, что изображение загружено, следует выполнить команду [[../requests/avl_evts|Другие запросы: События]]: | |
| |
<code=javascript> | |
{ | |
"tm":<uint>, /* текущее время сервера (UTC) */ | |
"events":[ | |
{ | |
"i":<long>, /* ID водителя (-1 - неизвестно) */ | |
"d":{ /* данные */ | |
"hash":"UploadUnitImage" /* загрузка завершена */ | |
} | |
} | |
] | |
} | |
</code> | |
| |