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

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

НазначениеНазначение

Получите начальный курсор для выбранной границы синхронизации. Вызывайте метод при отсутствии сохранённого курсора. Для следующих порций используйте POST /api/orders/changesForExecutors/get/v0 и передавайте сохранённый курсор в lastId.

Метод: POST /api/orders/changesForExecutors/getLastLogId/v0

ДоступДоступ

Нужны роль exec и право view_all_orders_exec. В выборку входят только доступные организации-исполнители.

Входные данныеВходные данные

Укажите executorId, если нужна одна доступная организация. Если поле опущено, метод проверяет все доступные организации-исполнители. Параметр может только сузить область доступа.

toTime — исключающая граница в формате RFC 3339. Метод ищет последнее изменение строго до указанного времени. Если параметр опущен, граница устанавливается за 32 дня до обработки запроса.

РезультатРезультат

id — курсор журнала изменений. Передайте его как lastId в POST /api/orders/changesForExecutors/get/v0. Метод ленты возвращает изменения с большим идентификатором. Для деталей выберите orderId из записей ленты и передайте их как exactOrderIds в POST /api/orders/v0/transferOrder/getFlatForExecutor. Перед запросом деталей можно убрать повторяющиеся идентификаторы. Описывайте заказ по ответу метода деталей.

Успешный ответ с id: 0 означает, что до границы в выбранной области нет изменений. Используйте 0 как начальный lastId.

Повтор запросаПовтор запроса

Метод только читает данные. Повторяйте запрос после временных сетевых ошибок и ошибок сервера. При ошибке доступа сначала устраните её причину.

Работа с чувствительными даннымиРабота с чувствительными данными

Выбирайте только идентификаторы, нужные для задачи. Передавайте исходные значения в ответ пользователю, контекст ИИ или внешнюю систему только по явному запросу, при подтверждённой необходимости и с действующим доступом. Исключите исходные значения из журналов, трассировок, метрик и диагностики. Используйте синтетические идентификаторы в примерах.

Проверенные примерыПроверенные примеры

Пример содержит синтетические данные. Для проверки документации используйте его без вызова рабочего сервиса.

Курсор перед заданным моментом · синтетический пример

Все идентификаторы и значения в примере синтетические.

Запрос

{
  "data": {
    "executorId": "executor-example",
    "toTime": "2000-01-02T00:00:00Z"
  }
}

Сокращённый ответ

{
  "data": {
    "id": 42001
  }
}

Ответ при отсутствии более раннего изменения.

{
  "data": {
    "id": 0
  }
}

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

RequestRequest

https://partner-test-yamagistrali.ru/api/orders/changesForExecutors/getLastLogId/v0

{
  "data": {
    "executorId": "example",
    "toTime": "2025-07-22T20:21:19.773333823Z"
  }
}

{
  "executorId": "example",
  "toTime": "2025-07-22T20:21:19.773333823Z"
}

{
  "executorId": "example",
  "toTime": "2025-07-22T20:21:19.773333823Z"
}

ResponsesResponses

{
  "data": {
    "id": 0
  }
}

{
  "id": 0
}

{
  "id": 0
}

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

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

{}

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

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

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

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

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