upload_trailer_image

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

Copied!
svc=resource/upload_trailer_image&params={"itemId":<long>,
					  					  "trailerId":<long>,
					  					  "eventHash":"<text>",
										  "oldItemId":<long>,
										  "oldTrId":<uint>}
                                &sid="<text>"

Параметры

НазваниеОписание
itemIdID ресурса.
trailerIdID прицепа.
eventHash

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

oldItemId

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

oldTagId

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

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

Пример:

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

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

{"itemId":717314,"trailerId":6,"eventHash":"jUploadForm1372768935931"}
------WebKitFormBoundaryLjl26xgAWBYzO713
Content-Disposition: form-data; name="eventHash"

jUploadForm1372768935931
------WebKitFormBoundaryLjl26xgAWBYzO713
Content-Disposition: form-data; name="trailers_dlg_props_upload_image"; filename="image.jpg"
Content-Type: image/jpeg


------WebKitFormBoundaryLjl26xgAWBYzO713--

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

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

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

Copied!
{ }

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

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

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

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

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

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

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

Скачать файл PDF
Скачать документ Word

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