update_driver
Функция update_driver используется для создания, редактирования или удаления водителей.
svc=resource/update_driver¶ms={"itemId":<long>,
"id":<long>,
"callMode":"<text>",
"ej":{"apps":[{"appId":"<text>","type":"<text>","uid":"<text>","sn":"<text>"},...]},
"c":"<text>",
"ck":<short>,
"ds":"<text>",
"n":"<text>",
"p":"<text>",
"r":<double>,
"f":<uint>,
"pwd":"<text>",
"jp":{
"<text>":"<text>",
...
}}
Параметры
Название | Описание | Необходим для | |||
---|---|---|---|---|---|
itemId | ID ресурса. | ||||
id | ID водителя (0 — создать). | ||||
callMode | Действие: создание, редактирование, удаление, удаление изображения (create, update, delete, reset_image). | ||||
создания | редактирования | reset_image | удаления | ||
ej | Расширенный JSON (с примером для push-уведомлений). | { } | { } | - | - |
c | Код. | + | + | - | - |
ck | Контрольная сумма изображения водителя. | - | - | - | - |
ds | Описание. | + | + | - | - |
n | Название. | + | + | - | - |
p | Телефонный номер. Например, +1234567890 ( + должен быть закодирован в %2B). | + | + | - | - |
r | Пропорции изображения водителя. | - | - | - | - |
f | Флаги (4 — исключающий). | 0 | 0 | - | - |
pwd | Пароль для авторизации с мобильного устройства. | + | + | - | - |
jp | Произвольные поля в формате "имя":"значение". | { } | { } | - | - |
“{ }” и “0” — значения по умолчанию.
Возвращаемый результат
Для запросов, связанных с созданием и редактированием водителей и с удалением изображений (reset_image):
[
<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>, /* время создания */
"mt":<uint>, /* время редактирования */
"bu":<long>, /* назначенный объект */
"pu":<long>, /* предыдущий назначенный объект */
"bt":<uint>, /* время последнего назначения/снятия */
"bs":<long>, /* ID датчика */
"pos":{ /* местоположение */
"y":<double>, /* широта */
"x":<double> /* долгота */
}
}
]
Флаги:
Флаг | Описание |
---|---|
0x1 | Тип объекта: Водитель. |
0x2 | Тип объекта: Прицеп. |
0x4 | Ограничить назначение. |
0x8 | Тип объекта: Группа водителей. |
0x10 | Тип объекта: Группа прицепов. |
Для запросов, связанных с удалением:
[
<long>, /* ID водителя */
null
]
Возможные коды ошибок:
Код | Описание |
---|---|
1002 | Не удалось изменить телефонный номер. Возможно по причине того, что этот номер уже существует. |
7 | Не удалось извлечь ресурс с требуемым ACL (ADF_ACL_AVL_RES_EDIT_DRIVERS). |
6 | Неопределенная ошибка. |
4 | Неверные входные параметры. |