Функция Sync Now от Didit в любой момент запрашивает у банка актуальные данные по подключению одним вызовом.
Живые синхронизации входят в ежемесячную стоимость подключения: дополнительная плата не взимается.
Единственное ограничение накладывает банк.
Автоматическая синхронизация
- Первая синхронизация запускается, когда пользователь подключается.
- После этого каждое активное постоянное подключение синхронизируется автоматически от одного до четырёх раз в день, в зависимости от банка.
sync.frequency_per_day в подключении показывает, сколько раз, а sync.next_sync_at показывает, когда запланирована следующая.
- Если банк разрешает больше считываний в день без участия пользователя, как минимум два в день всегда остаются для синхронизаций в реальном времени.
- Когда синхронизация сохраняет изменения, приходит
bank.data.updated, и вы читаете ленту изменений с помощью своего курсора.
- Синхронизация, которая завершилась ошибкой, повторяется с увеличивающимися интервалами между попытками. Если ошибки продолжаются 24 часа, подключение остаётся
active со значением sync.status: failing, и отправляется bank.sync.failed. Когда синхронизация снова работает, следует bank.sync.recovered.
- Когда банк просит пользователя войти снова, подключение переходит в статус
renewal_required.
Синхронизируйте сейчас одним вызовом
Добавьте "wait": true, и один запрос вернёт актуальные данные:
Заголовок Prefer: wait=25 делает то же самое. Вызов ожидает до 25 секунд:
Если синхронизация уже выполняется, вы получите тот же sync_id, а не новую задачу.
После ответа 200 или события bank.data.updated прочитайте ленту изменений, используя сохранённый курсор.
Чтобы позже посмотреть, что делала синхронизация, воспользуйтесь get_sync_run.
Цена
Автоматические синхронизации и синхронизации в реальном времени входят в ежемесячную цену подключения, см. Цены.
Синхронизация в реальном времени никогда не влечёт дополнительной платы.
Дневной лимит банка
Банк ограничивает, как часто данные можно запрашивать без участия человека.
Правила в Европе позволяют банку ограничить такой доступ без участия человека четырьмя чтениями данных в день на счёт.
Это верхняя граница, а не гарантия: банк может разрешить меньше или согласиться на большее.
- Автоматические синхронизации и синхронизации в реальном времени используют один общий бюджет, и автоматическое расписание никогда не использует последние два чтения за день.
sync.live_syncs_left_today в подключении показывает, сколько синхронизаций в реальном времени осталось на сегодня, а sync.budgets[] показывает каждую группу лимита: scope (connection или account), resource, limit, remaining и resets_at.
- Пока пользователь находится в Bank Link для продления или повторного подключения, обращения не ограничиваются.
- Когда дневной бюджет исчерпан, вызов возвращает
429 refresh_limit_reached с заголовком Retry-After (количество секунд до сброса бюджета) и объектом sync с полями live_syncs_left_today и budgets. Подождите указанное время, а тем временем полагайтесь на автоматическую синхронизацию.
- Лимиты вашего API независимы: 600 чтений и 300 операций записи в минуту на приложение, с заголовками
X-RateLimit-*.
Как узнать, насколько актуальны данные
sync.last_synced_at в подключении и в каждом счёте означает время, когда Didit в последний раз получил данные из банка, а не время, когда вы их в последний раз считывали.
- Оба запроса на чтение транзакций возвращают
X-Bank-Last-Synced-At.
Ошибки, которые нужно обрабатывать
Связанные материалы
Последнее изменение 22 ноября 2026 г.