Перейти к основному содержанию
Функция 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 г.