Получить изменения рейсов исполнителя

Порядок работы для агента · Методы API и схема OpenAPI.

Назначение

Читайте события с id больше data.lastId. По умолчанию размер порции data.limit равен 100, максимум — 1000. Для одной организации укажите data.executorId. Нужны роль исполнителя и право flight_view_changes_exec. Записи из data.changes содержат flightId и массив связанных orderId. Храните идентификаторы и полный ответ в клиенте.

Блоки запроса и ответов ниже сгенерированы из OpenAPI. Подстановки вроде example показывают структуру JSON. Для вызова возьмите значения из сценария, справочников или предыдущих ответов API.

Request

POST

https://partner-test-yamagistrali.ru/api/flight/changesForExecutors/get/v0

Тестовый стенд

Body

application/json
{
  "data": {
    "executorId": "example",
    "lastId": 0,
    "limit": 0
  }
}

Name

Description

data

Type: FlightChangesForExecutorsGetV0Request

Example
{
  "executorId": "example",
  "lastId": 0,
  "limit": 0
}

FlightChangesForExecutorsGetV0Request

Name

Description

executorId

Type: string | null

Example: example

lastId

Type: integer | null

limit

Type: integer | null

Example
{
  "executorId": "example",
  "lastId": 0,
  "limit": 0
}

Responses

200 OK

OK

Body

application/json
{
  "data": {
    "changes": [
      {
        "executorId": "example",
        "flightId": "example",
        "id": 0,
        "orderId": [
          "example"
        ],
        "updatedAt": "2025-07-22T20:21:19.773333823Z"
      }
    ]
  }
}

Name

Description

data

Type: FlightChangesForExecutorsGetV0Response

Example
{
  "changes": [
    {
      "executorId": "example",
      "flightId": "example",
      "id": 0,
      "orderId": [
        "example"
      ],
      "updatedAt": "2025-07-22T20:21:19.773333823Z"
    }
  ]
}

FlightChangesForExecutorsGetV0Item

Name

Description

executorId

Type: string

Example: example

flightId

Type: string

Example: example

id

Type: integer

updatedAt

Type: string

Example: 2025-07-22T20:21:19.773333823Z

orderId

Type: string[] | null

Example
[
  "example"
]
Example
{
  "executorId": "example",
  "flightId": "example",
  "id": 0,
  "orderId": [
    "example"
  ],
  "updatedAt": "2025-07-22T20:21:19.773333823Z"
}

FlightChangesForExecutorsGetV0Response

Name

Description

changes

Type: FlightChangesForExecutorsGetV0Item[] | null

Example
[
  {
    "executorId": "example",
    "flightId": "example",
    "id": 0,
    "orderId": [
      "example"
    ],
    "updatedAt": "2025-07-22T20:21:19.773333823Z"
  }
]
Example
{
  "changes": [
    {
      "executorId": "example",
      "flightId": "example",
      "id": 0,
      "orderId": [
        "example"
      ],
      "updatedAt": "2025-07-22T20:21:19.773333823Z"
    }
  ]
}

400 Bad Request

Bad Request

Body

application/json
{
  "error": {
    "info": {},
    "message": "example",
    "message_code": "example"
  }
}

Name

Description

error

Type: Error

Example
{
  "info": {},
  "message": "example",
  "message_code": "example"
}

Error

Name

Description

info

Type: object

Example
{}

message

Type: string

Example: example

message_code

Type: string

Example: example

Example
{
  "info": {},
  "message": "example",
  "message_code": "example"
}

403 Forbidden

Forbidden

Body

application/json
{
  "error": {
    "info": {},
    "message": "example",
    "message_code": "example"
  }
}

Name

Description

error

Type: Error

Example
{
  "info": {},
  "message": "example",
  "message_code": "example"
}

500 Internal Server Error

Internal Server Error

Body

application/json
{
  "error": {
    "info": {},
    "message": "example",
    "message_code": "example"
  }
}

Name

Description

error

Type: Error

Example
{
  "info": {},
  "message": "example",
  "message_code": "example"
}