get_orders_history
Чтобы получить историю заявок, используйте метод order/get_orders_history.
Для использования метода необходимо право доступа Запрос сообщений и отчетов к ресурсу.
Конечная точка
svc=order/get_orders_history¶ms={
"itemId":<long>,
"ivalType":<int>,
"ivalFrom":<uint>,
"ivalTo":<uint>,
"name":"<text>",
"unitId":<long>,
"orderId":<long>,
"orderUid":<long>,
"routeId":<long>
}
Параметры
Обязательные параметры отмечены звездочкой (*).
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
itemId* |
ID ресурса. | |
ivalType |
1 |
Метод выбора интервала. Значения такие же, как у параметра ivalType метода events/load, но вместо timeFrom и timeTo используются ivalFrom и ivalTo. |
ivalFrom |
0 |
Зависит от ivalType: начало интервала (время в формате UNIX) или количество заявок для загрузки. |
ivalTo |
UINT_MAX |
Конец интервала (время в формате UNIX). |
name |
Маски имен заявок через запятую. Заявка возвращается, если ее имя соответствует хотя бы одной маске. Используйте * для любого количества символов, ? для ровно одного символа и ! в начале маски, чтобы инвертировать ее. Например, "Vil*,Berl*" возвращает заявки, имена которых начинаются на Vil или Berl, "*kr" возвращает заявки, имена которых заканчиваются на kr, а "!Vil*" возвращает заявки, имена которых не начинаются на Vil. |
|
unitId |
ID объекта. | |
orderId |
ID заявки. Один и тот же ID может встречаться в истории несколько раз. | |
orderUid |
Уникальный ID заявки. | |
routeId |
Уникальный ID маршрута (свойство маршрута uid). |
Ответ
Если запрос выполнен успешно, возвращается следующий результат:
{
"orders":[
{...},
{...},
...
],
"count":<uint>, /* количество отфильтрованных заявок (размер "orders") */
"total":<uint> /* общее количество заявок за запрашиваемый период */
}
При неудачном выполнении возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры. |
| 6 | Не удалось загрузить историю, например, из-за недопустимого значения ivalType. |
| 7 | Ресурс не существует, или у пользователя нет права доступа Запрос сообщений и отчетов к нему. |