upload_driver_image

Функция upload_driver_image используется для прикрепления изображения к водителю.

Copied!
svc=resource/upload_driver_image&params={"itemId":<long>,
				         				 "driverId":<long>,
				         				 "eventHash":"<text>",
										 "oldItemId":<long>,
										 "oldDrvId":<uint>}
                                 &sid="<text>"

Параметры

НазваниеОписание
itemIdID ресурса.
driverIdID водителя.
eventHash

Имя события, которое должно быть сгенерировано после прикрепления изображения. Необязательный параметр.

oldItemId

ID ресурса, из которого должно быть скопировано изображение водителя. Необязательный параметр.

oldTagId

ID водителя, изображение которого должно быть скопировано. Необязательный параметр.

Чтобы загрузить изображение, используйте запрос POST (multipart/form-data), в котором в одной части содержатся параметры, а в другой — изображение.

Пример:

Copied!
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=resource/upload_driver_image
Request Method: POST
Host: hst-api.wialon.com
Connection: keep-alive
Content-Length: 31755
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryB4wasXYYHLTNXHBl
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

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

{"itemId":717314,"driverId":17,"eventHash":"jUploadForm1372768554999"}
------WebKitFormBoundaryB4wasXYYHLTNXHBl
Content-Disposition: form-data; name="eventHash"

jUploadForm1372768554999
------WebKitFormBoundaryB4wasXYYHLTNXHBl
Content-Disposition: form-data; name="drivers_dlg_props_upload_image"; filename="image.jpg"
Content-Type: image/jpeg

------WebKitFormBoundaryB4wasXYYHLTNXHBl--

Также можно скопировать изображение из другого водителя. Для этого выполните запрос без изображения, но с полями oldItemId и oldDrvId.

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

Если запрос выполнен успешно, возвращается пустой JSON.

Copied!
{ }

В противном случае возвращается код ошибки. Возможные коды ошибок:

КодОписание
7

Не удалось извлечь элемент с требуемым ACL (ADF_ACL_AVL_RES_EDIT_DRIVERS) или не удалось найти элемент/водителя с old_id (при копировании изображения из другого водителя).

6Неопределенная ошибка.
4

Неверные входные параметры.

Чтобы убедиться, что изображение загружено, выполните запрос avl_evts:

Copied!
{
	"tm":<uint>,				/* текущее время сервера (UTC) */
	"events":[
		{
			"i":<long>,			/* ID водителя (-1, если неизвестно) */
			"d":{				/* данные */
				"hash":"<text>"		/* загрузка завершена */
			}
		}
	]
}
Скачать файл PDF
Скачать документ Word

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