update_trailer
Чтобы создать, изменить или удалить прицепы, используйте метод resource/update_trailer.
Конечная точка
svc=resource/update_trailer¶ms={
"itemId": <long>,
"id": <long>,
"callMode": <text>,
"n": <text>,
"c": <text>,
"ds": <text>,
"f": <uint>,
"ej": { ... },
"jp": {
<text>: <text>,
...
}
}
Параметры
Запрос должен содержать следующие параметры:
| Параметр | Описание |
|---|---|
itemId |
ID ресурса. |
id |
ID прицепа. Для создания прицепа отправьте 0. |
callMode |
Тип действия: create, update, delete, reset_image (удаление изображения прицепа). |
n |
Имя прицепа. Обязательно только для типов действия create и update. |
c |
Код прицепа. Обязателен только для типов действия create и update. |
ds |
Описание прицепа. Обязательно только для типов действия create и update. |
f |
Флаги, в настоящее время не используются. Необязательно. |
ej |
Расширенный JSON. Необязательно. Если параметр не указан, при создании прицепа устанавливается {}, а при изменении сохраняется текущее значение. |
jp |
Произвольные поля в формате "имя":"значение". Необязательно. Если параметр не указан, произвольные поля очищаются. |
Ответ
При успешном выполнении запроса на создание или изменение прицепа либо на удаление его изображения возвращается результат в следующем формате:
[
<long>, /* ID прицепа. */
{
"id": <long>, /* ID прицепа. */
"n": <text>, /* Имя. */
"c": <text>, /* Код. */
"ej": { ... }, /* Расширенный JSON. */
"jp": { /* Произвольные поля. */
<text>: <text>, /* Имя: значение. */
...
},
"pwd": <text>, /* Пароль для мобильной авторизации (не используется для прицепов). */
"ds": <text>, /* Описание. */
"p": <text>, /* Телефонный номер. */
"r": <double>, /* Пропорции изображения. */
"f": <uint>, /* Флаги. */
"ck": <ushort>, /* Контрольная сумма изображения. */
"ct": <uint>, /* Время создания (формат Unix). */
"mt": <uint>, /* Время последнего изменения (формат Unix). */
"bu": <long>, /* Назначенный объект. */
"pu": <long>, /* Предыдущий назначенный объект. */
"bt": <uint>, /* Время последнего назначения/снятия. */
"bs": <long>, /* ID датчика, подтверждающего назначение. */
"pos": { /* Местоположение. */
"y": <double>, /* Широта. */
"x": <double> /* Долгота. */
}
}
]
При успешном выполнении запроса на удаление прицепа возвращается результат в следующем формате:
[
<long>, /* ID прицепа. */
null
]
Если запрос выполнить не удалось, возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры. Для типа действия update эта ошибка также возвращается, если прицеп с указанным ID не существует. |
| 6 | Неопределенная ошибка. Для типов действия delete и reset_image эта ошибка также возвращается, если прицеп с указанным ID не существует. |
| 7 | Ресурс не существует, или у пользователя нет права доступа Создание, редактирование и удаление прицепов к нему. |