Получение списка заказов
Получение списка заказов
HTTP-запрос
POST https://fleet-api.taxi.yandex.net/v1/parks/orders/list
Заголовки запроса
* Обязательный параметр
Тело запроса
{ "cursor": "string", "limit": 100, "query": { "park": { "car": { "id": "5011ade6ba054dfdb7143c8cc9460dbc" }, "driver_profile": { "id": "33de650c6a1a40bfa78dd981817da866" }, "id": "ee6f33c4562b4e1f8646d157bd70b2c4", "order": { "booked_at": { "from": "2019-08-08T11:58:01+03:00", "to": "2019-08-08T11:58:01+03:00" }, "categories": [ "econom" ], "ended_at": { "from": "2019-08-08T11:58:01+03:00", "to": "2019-08-08T11:58:01+03:00" }, "ids": [ "c8d40acf182b4b32af72f6ad2029031b" ], "payment_methods": [ "card" ], "price": { "from": "12345.1434", "to": "12345.1434" }, "providers": [ "platform" ], "short_ids": [ 248 ], "statuses": [ "complete" ], "type": { "ids": [ "4964b852670045b196e526d59915b777" ] } } } } }
Скопировано
Представление
Поля
cursor | string Курсор для получения следующий порции данных, |
limit * | integer Ограничение сверху на число заказов в ответе Минимальное значение: |
query * | object |
query. | object |
query. | object |
query. | string Идентификатор автомобиля |
query. | object |
query. | string Идентификатор водителя |
query. | string Идентификатор партнёра |
query. | object Обязательно наличие одного из booked_at или ended_at |
query. | object |
query. | string ISO 8601 с временной зоной |
query. | string ISO 8601 с временной зоной |
query. | array Список категорий ТС. Допустимые значения:
|
query. | object |
query. | string ISO 8601 с временной зоной |
query. | string ISO 8601 с временной зоной |
query. | array |
query. | array |
query. | object |
query. | string Сумма с фиксированной точностью |
query. | string Сумма с фиксированной точностью |
query. | array |
query. | array |
query. | array |
query. | object |
query. | array |
cursor | string Курсор для получения следующий порции данных, |
limit * | integer Ограничение сверху на число заказов в ответе Минимальное значение: |
query * | object |
query. | object |
query. | object |
query. | string Идентификатор автомобиля |
query. | object |
query. | string Идентификатор водителя |
query. | string Идентификатор партнёра |
query. | object Обязательно наличие одного из booked_at или ended_at |
query. | object |
query. | string ISO 8601 с временной зоной |
query. | string ISO 8601 с временной зоной |
query. | array Список категорий ТС. Допустимые значения:
|
query. | object |
query. | string ISO 8601 с временной зоной |
query. | string ISO 8601 с временной зоной |
query. | array |
query. | array |
query. | object |
query. | string Сумма с фиксированной точностью |
query. | string Сумма с фиксированной точностью |
query. | array |
query. | array |
query. | array |
query. | object |
query. | array |
* Обязательный параметр
Ответы
Код 200
Список заказов
{ "cursor": "", "limit": 100, "orders": [ { "address_from": { "address": "Тверская улица, 8", "lat": 55.762235, "lon": 37.609651 }, "amenities": [ "wifi" ], "booked_at": "2019-08-08T11:58:01+03:00", "cancellation_description": "string", "car": { "brand_model": "BMW 5er", "callsign": "123456789", "id": "5011ade6ba054dfdb7143c8cc9460dbc", "license": { "number": "AA01234567" } }, "category": "econom", "created_at": "2019-08-08T11:58:01+03:00", "driver_profile": { "id": "33de650c6a1a40bfa78dd981817da866", "name": "Иванов Пётр Николаевич" }, "driver_work_rule": { "id": "e26a3cf21acfe01198d50030487e046b", "name": "Аренда" }, "ended_at": "2019-08-08T11:58:01+03:00", "events": [ { "event_at": "2019-08-08T11:58:01+03:00", "order_status": "complete" } ], "id": "c8d40acf182b4b32af72f6ad2029031b", "mileage": "string", "park_details": { "company": { "comment": "string", "id": "string", "name": "string", "slip": "string" }, "passenger": { "name": "string", "phones": [ "string" ] }, "tariff": { "id": "string", "name": "string" } }, "payment_method": "card", "price": "12345.1434", "provider": "platform", "route_points": [ { "address": "Тверская улица, 8", "lat": 55.762235, "lon": 37.609651 } ], "short_id": 248, "status": "complete", "type": { "id": "4964b852670045b196e526d59915b777", "name": "Яндекс.Безналичный" } } ] }
Скопировано
Представление
Поля
cursor | string Курсор для получения следующий порции данных |
limit * | integer Ограничение сверху на число заказов в ответе Минимальное значение: |
orders[] * | array |
orders[]. | object |
orders[]. | string Адрес заказа |
orders[]. | number Географическая широта |
orders[]. | number Географическая долгота |
orders[]. | array Удобства в ТС. Допустимые значения:
|
orders[]. | string ISO 8601 с временной зоной |
orders[]. | string |
orders[]. | object |
orders[]. | string Марка и модель автомобиля |
orders[]. | string Позывной |
orders[]. | string Идентификатор автомобиля |
orders[]. | object |
orders[]. | string Регистрационный номер ТС |
orders[]. | string Категория ТС. Допустимые значения:
|
orders[]. | string ISO 8601 с временной зоной |
orders[]. | object |
orders[]. | string Идентификатор водителя |
orders[]. | string ФИО водителя |
orders[]. | object Условие работы водителя |
orders[]. | string Идентификатор условия работы водителя |
orders[]. | string Название условия работы водителя |
orders[]. | string ISO 8601 с временной зоной |
orders[]. | array |
orders[]. | string ISO 8601 с временной зоной |
orders[]. | string Статус заказа. Допустимые значения:
|
orders[]. | string Идентификатор заказа |
orders[]. | string |
orders[]. | object |
orders[]. | object |
orders[]. | string |
orders[]. | string |
orders[]. | string |
orders[]. | string |
orders[]. | object |
orders[]. | string |
orders[]. | array |
orders[]. | object Тарифы парка |
orders[]. | string |
orders[]. | string |
orders[]. | string Способ оплаты. Допустимые значения:
|
orders[]. | string Сумма с фиксированной точностью |
orders[]. | string Возможные значения
|
orders[]. | array |
orders[]. | string Адрес заказа |
orders[]. | number Географическая широта |
orders[]. | number Географическая долгота |
orders[]. | integer Порядковый номер заказ (с учётом несостоявшихся заказов) Минимальное значение: |
orders[]. | string Статус заказа. Допустимые значения:
|
orders[]. | object |
orders[]. | string Идентификатор типа заказа |
orders[]. | string Название типа заказа |
cursor | string Курсор для получения следующий порции данных |
limit * | integer Ограничение сверху на число заказов в ответе Минимальное значение: |
orders[] * | array |
orders[]. | object |
orders[]. | string Адрес заказа |
orders[]. | number Географическая широта |
orders[]. | number Географическая долгота |
orders[]. | array Удобства в ТС. Допустимые значения:
|
orders[]. | string ISO 8601 с временной зоной |
orders[]. | string |
orders[]. | object |
orders[]. | string Марка и модель автомобиля |
orders[]. | string Позывной |
orders[]. | string Идентификатор автомобиля |
orders[]. | object |
orders[]. | string Регистрационный номер ТС |
orders[]. | string Категория ТС. Допустимые значения:
|
orders[]. | string ISO 8601 с временной зоной |
orders[]. | object |
orders[]. | string Идентификатор водителя |
orders[]. | string ФИО водителя |
orders[]. | object Условие работы водителя |
orders[]. | string Идентификатор условия работы водителя |
orders[]. | string Название условия работы водителя |
orders[]. | string ISO 8601 с временной зоной |
orders[]. | array |
orders[]. | string ISO 8601 с временной зоной |
orders[]. | string Статус заказа. Допустимые значения:
|
orders[]. | string Идентификатор заказа |
orders[]. | string |
orders[]. | object |
orders[]. | object |
orders[]. | string |
orders[]. | string |
orders[]. | string |
orders[]. | string |
orders[]. | object |
orders[]. | string |
orders[]. | array |
orders[]. | object Тарифы парка |
orders[]. | string |
orders[]. | string |
orders[]. | string Способ оплаты. Допустимые значения:
|
orders[]. | string Сумма с фиксированной точностью |
orders[]. | string Возможные значения
|
orders[]. | array |
orders[]. | string Адрес заказа |
orders[]. | number Географическая широта |
orders[]. | number Географическая долгота |
orders[]. | integer Порядковый номер заказ (с учётом несостоявшихся заказов) Минимальное значение: |
orders[]. | string Статус заказа. Допустимые значения:
|
orders[]. | object |
orders[]. | string Идентификатор типа заказа |
orders[]. | string Название типа заказа |
* Обязательный параметр
Код 400
Некорректные параметры запроса
{ "code": "string", "message": "Текстовое описание ошибки" }
Скопировано
Представление
Поля
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
* Обязательный параметр
Код 401
Отсутствуют параметры авторизации запроса
{ "code": "string", "message": "Текстовое описание ошибки" }
Скопировано
Представление
Поля
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
* Обязательный параметр
Код 403
Недостаточно прав для выполнения запроса
{ "code": "string", "message": "Текстовое описание ошибки" }
Скопировано
Представление
Поля
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
* Обязательный параметр
Код 429
Превышено допустимое число запросов
{ "code": "string", "message": "Текстовое описание ошибки" }
Скопировано
Представление
Поля
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
* Обязательный параметр
Код 500
Внутренняя ошибка сервера
{ "code": "string", "message": "Текстовое описание ошибки" }
Скопировано
Представление
Поля
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
code | string Машиночитаемый код ошибки |
message * | string Человекочитаемое сообщение об ошибке |
* Обязательный параметр
Пример
Request:
curl -X POST "https://fleet-api.taxi.yandex.net/v1/parks/orders/list" \ -H "X-Client-ID: <Идентификатор клиента>" \ -H "X-API-Key: <API-ключ>" \ -d '{ "limit": 100, "query": { "park": { "car": { "id": "5011ade6ba054dfdb7143c8cc9460dbc" }, "driver_profile": { "id": "33de650c6a1a40bfa78dd981817da866" }, "id": "ee6f33c4562b4e1f8646d157bd70b2c4", "order": { "booked_at": { "from": "2019-08-08T11:58:01+03:00", "to": "2019-08-08T11:58:01+03:00" }, "categories": [ "econom" ], "ended_at": { "from": "2019-08-08T11:58:01+03:00", "to": "2019-08-08T11:58:01+03:00" }, "ids": [ "c8d40acf182b4b32af72f6ad2029031b" ], "payment_methods": [ "card" ], "price": { "from": "12345.1434", "to": "12345.1434" }, "providers": [ "platform" ], "short_ids": [ 248 ], "statuses": [ "complete" ], "type": { "ids": [ "4964b852670045b196e526d59915b777" ] } } } } }'
Скопировано
Responses:
{ "cursor": "", "limit": 100, "orders": [ { "address_from": { "address": "Тверская улица, 8", "lat": 55.762235, "lon": 37.609651 }, "amenities": [ "wifi" ], "booked_at": "2019-08-08T11:58:01+03:00", "car": { "brand_model": "BMW 5er", "callsign": "123456789", "id": "5011ade6ba054dfdb7143c8cc9460dbc", "license": { "number": "AA01234567" } }, "category": "econom", "created_at": "2019-08-08T11:58:01+03:00", "driver_profile": { "id": "33de650c6a1a40bfa78dd981817da866", "name": "Иванов Пётр Николаевич" }, "driver_work_rule": { "id": "e26a3cf21acfe01198d50030487e046b", "name": "Аренда" }, "ended_at": "2019-08-08T11:58:01+03:00", "events": [ { "event_at": "2019-08-08T11:58:01+03:00", "order_status": "complete" } ], "id": "c8d40acf182b4b32af72f6ad2029031b", "park_details": { "passenger": { "phones": [ null ] } }, "payment_method": "card", "price": "12345.1434", "provider": "platform", "route_points": [ { "address": "Тверская улица, 8", "lat": 55.762235, "lon": 37.609651 } ], "short_id": 248, "status": "complete", "type": { "id": "4964b852670045b196e526d59915b777", "name": "Яндекс.Безналичный" } } ] }
Скопировано
{ "message": "Текстовое описание ошибки" }
Скопировано
{ "message": "Текстовое описание ошибки" }
Скопировано
{ "message": "Текстовое описание ошибки" }
Скопировано
{ "message": "Текстовое описание ошибки" }
Скопировано
{ "message": "Текстовое описание ошибки" }
Скопировано