Получение списка заявок исполнителей из гаража

Получение списка заявок исполнителей из гаража с пагинацией

Request

GET

https://fleet-api.taxi.yandex.net/v1/parks/contractors/applications/list

Query parameters

Name

Description

cursor

Type: string

Курсор для получения следующий порции данных

Example: eyJsZWFkX2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIn0=

limit

Type: integer

Ограничение количества элементов в ответе

Default: 100

Min value: 1

Max value: 100

Headers

Name	Description
X-API-Key	Type: string API-ключ Min length: `1` Example: `<API-ключ>`
X-Client-ID	Type: string Идентификатор клиента Min length: `1` Example: `<Идентификатор клиента>`
X-Park-ID	Type: string Идентификатор партнера Example: `ee6f33c4562b4e1f8646d157bd70b2c4`

Responses

200 OK

Список заявок на автомобили

Body

application/json

{
  "items": [
    {
      "lead_id": "550e8400-e29b-41d4-a716-446655440000",
      "driver_id": "33de650c6a1a40bfa78dd981817da866",
      "phone": "+79999999999",
      "vehicle_id": "5011ade6ba054dfdb7143c8cc9460dbc",
      "schema": {
        "price": "1500.0000",
        "working_days": 6,
        "non_working_days": 1
      },
      "request_type": "multiple",
      "created_at": "2023-12-15T09:00:00+03:00",
      "updated_at": "2023-12-15T14:30:00+03:00"
    }
  ],
  "cursor": "eyJsZWFkX2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIn0="
}

Name

Description

items

Type: ContractorApplicationItem[]

Список заявок

Example

[
  {
    "lead_id": "550e8400-e29b-41d4-a716-446655440000",
    "driver_id": "33de650c6a1a40bfa78dd981817da866",
    "phone": "+79999999999",
    "vehicle_id": "5011ade6ba054dfdb7143c8cc9460dbc",
    "schema": {
      "price": "1500.0000",
      "working_days": 6,
      "non_working_days": 1
    },
    "request_type": "multiple",
    "created_at": "2023-12-15T09:00:00+03:00",
    "updated_at": "2023-12-15T14:30:00+03:00"
  }
]

cursor

Type: string

Курсор для получения следующей страницы

Example: eyJsZWFkX2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIn0=

ContractorApplicationItem

Name

Description

lead_id

Type: string<uuid>

Идентификатор лида

Example: 550e8400-e29b-41d4-a716-446655440000

phone

Type: string

Номер телефона

Example: +79999999999

vehicle_id

Type: string

Идентификатор автомобиля

Example: 5011ade6ba054dfdb7143c8cc9460dbc

created_at

Type: string<date-time>

Дата и время создания заявки

Example: 2023-12-15T09:00:00+03:00

driver_id

Type: string

Идентификатор водителя

Example: 33de650c6a1a40bfa78dd981817da866

request_type

Type: string

Тип заявки: phonecall - создана по телефонному звонку, multiple - мультибронирование

Enum: phonecall, multiple

schema

Type: object

non_working_days

Type: integer

Количество дней когда авто не сдается в аренду

price

Type: string

Стоимость аренды в сутки

Pattern: ^[0-9]+(\.[0-9]{1,4})?$

Example: 1500.0000

working_days

Type: integer

Количество дней когда авто сдается в аренду

Схема аренды

Example

{
  "price": "1500.0000",
  "working_days": 6,
  "non_working_days": 1
}

updated_at

Type: string<date-time>

Дата и время обновления заявки

Example: 2023-12-15T14:30:00+03:00

Example

{
  "lead_id": "550e8400-e29b-41d4-a716-446655440000",
  "driver_id": "33de650c6a1a40bfa78dd981817da866",
  "phone": "+79999999999",
  "vehicle_id": "5011ade6ba054dfdb7143c8cc9460dbc",
  "schema": {
    "price": "1500.0000",
    "working_days": 6,
    "non_working_days": 1
  },
  "request_type": "multiple",
  "created_at": "2023-12-15T09:00:00+03:00",
  "updated_at": "2023-12-15T14:30:00+03:00"
}

400 Bad Request

Некорректные параметры запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

401 Unauthorized

Отсутствуют параметры авторизации запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

403 Forbidden

Недостаточно прав для выполнения запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

429 Too Many Requests

Превышено допустимое число запросов

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

500 Internal Server Error

Внутренняя ошибка сервера

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

Была ли статья полезна?

Получение баланса и заблокированного баланса водителя

Получение списка условий работы