update_round
Чтобы создать, изменить или удалить рейс, используйте метод route/update_round:
svc=route/update_round
params={
"itemId": <long>,
"id": <long>,
"callMode": <text>,
"n": <text>,
"d": <text>,
"u": <long>,
"at": <uint>,
"vt": <uint>,
"vp": <uint>,
"sh": <long>,
"cu": [<long>],
"f": <uint>,
"tz": <uint>
}
Параметры
Запрос должен содержать следующие параметры:
| Параметр | Описание |
|---|---|
| itemId | ID маршрута. |
| id | ID рейса. |
| callMode | Действие: create, update, delete. |
| sh | ID расписания. Обязателен, если действие — create или update. |
Описание остальных параметров см. на странице get_round_data.
Ответ
Если запрос выполнен успешно, формат ответа зависит от действия, указанного в параметре callMode.
Ответ на запрос создания или обновления рейса возвращается в следующем формате:
[
<long>, // ID рейса.
{
"id": <long>, // ID рейса.
"ct": <long>, // Время создания рейса (UNIX).
"mt": <long>, // Время обновления рейса (UNIX).
"n": <text>, // Название.
"d": <text>, // Описание.
"sh": <text>, // Название расписания.
"f": <uint>, // Флаги рейса.
"tz": <uint>, // Часовой пояс.
"u": <long>, // Назначенный объект. Если не указан, в этом поле отображается первый объект из массива "cu", который отправляется с первой контрольной точки.
"at": <uint>, // Время активации.
"vt": <uint>, // Начало периода действия.
"vp": <uint>, // Период действия.
"sts": <uint>, // Флаги состояния рейса.
"st": { // Состояние рейса.
"st": { // Общее состояние рейса.
"pi": <uint>, // Индекс контрольной точки (4294967295, если рейс не начат).
"ps": <uint>, // Флаги состояния и флаги событий.
"ut": <uint> // Время последнего события.
},
"pts": { // Состояние по контрольной точке.
"<checkpoint_id>": {
"st": <uint>, // Флаги событий.
"tm": <uint> // Время последнего события.
}
// ... дополнительные контрольные точки
}
}
}
]
Флаги состояния и флаги событий рейса описаны на странице get_round_data.
Ответ на запрос удаления рейса возвращается в следующем формате:
[
<long>, // ID рейса.
null
]
Если запрос не выполнен, возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Одна из следующих ошибок:
|
| 6 | Внутренняя ошибка. |
| 7 | Внутренняя ошибка. |