Перейти к основному содержанию
GET
curl
Эндпоинт Sync Transactions в Didit возвращает изменения в транзакциях подключения с момента указанного курсора: added, modified и removed. Пустой курсор возвращает все транзакции с reset: true. Сохраняйте next_cursor только после ответа с has_more: false. См. Непрерывный банковский фид для бухгалтерии.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения берётся в разделе Developers -> API keys в Business Console. Основной ключ имеет полный доступ. Именованный ключ можно ограничить: доступ для каждого ресурса (нет доступа, только чтение или запись), ограничение некоторыми сценариями или одобренными сессиями, список IP-адресов и дата истечения срока. Ответ 401 означает, что ключ неверный, отозван или истёк. Ответ 403 означает, что ключ не передан, у ключа нет доступа к этому ресурсу или действию либо запрос пришёл с адреса вне его списка IP. Ответ 404 на маршруте сессии означает, что сессия находится вне сценариев или статусов, доступных ключу. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без права записи в сессии получает ссылки и токены сессий как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

id
string<uuid>
обязательно

Идентификатор подключения.

Параметры запроса

cursor
string

Сохранённый вами next_cursor. Если значение пустое или не передано, выборка начинается с начала.

limit
integer
по умолчанию:100

Размер страницы: от 1 до 500. По умолчанию 100.

Требуемый диапазон: 1 <= x <= 500
page_token
string

Продолжает то же чтение, пока has_more равно true.

Ответ

Страница изменений.

Изменения транзакций подключения начиная с курсора. Пустой курсор возвращает все текущие транзакции как added. Все страницы одного чтения отражают один и тот же снимок; изменения, поступившие в это время, попадут в следующее чтение.

added
object[]
обязательно

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

modified
object[]
обязательно

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

removed
object[]
обязательно

Транзакции, которых больше не существует, с полем reason. Игнорируйте id, которого у вас нет: транзакция, удалённая во время постраничного чтения при первом запросе, один раз была доставлена как added и придёт в следующем чтении.

has_more
boolean
обязательно

true, пока есть следующие страницы. Сохраняйте next_cursor только после ответа с has_more: false; если пагинация прервалась на середине, начните заново с сохраненного курсора.

next_page_token
string | null
обязательно

Продолжает это чтение, пока has_more равно true.

next_cursor
string | null
обязательно

Долговременная контрольная точка ленты, возвращается только на последней странице. Непрозрачна и привязана к приложению, среде и подключению. Может воспроизводиться в течение 90 дней. При первом чтении отмечает момент начала чтения, поэтому изменения, произошедшие за это время, придут в следующем чтении.

reset
boolean
обязательно

true при каждой первичной загрузке, то есть при каждом чтении с пустого курсора: замените свою копию результатом, а не добавляйте к ней.

Последнее изменение 22 ноября 2026 г.