upload_tag_image

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

Copied!
svc=resource/upload_tag_image&params={"itemId":<long>,
				      				  "tagId":<long>,
				      				  "eventHash":"<text>",
									  "oldItemId":<long>,
									  "oldTagId":<uint>}
                             &sid="<text>"

Параметры

НазваниеОписание
itemIdID ресурса.
tagIdID метки.
eventHash

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

oldItemId

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

oldTagId

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

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

Пример:

Copied!
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=resource/upload_tag_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,"tagId":17,"eventHash":"jUploadForm1372768554999"}
------WebKitFormBoundaryB4wasXYYHLTNXHBl
Content-Disposition: form-data; name="eventHash"

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

------WebKitFormBoundaryB4wasXYYHLTNXHBl--

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

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

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

Copied!
{ }

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

CodeDescription
7

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

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

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

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

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

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