Перейти к основному содержанию
POST
curl
Endpoint Didit Refresh a Bank Connection запрашивает синхронизацию прямо сейчас и возвращает 202 с sync_id. Отправьте "wait": true, чтобы ждать до 25 секунд и получить результат завершённой синхронизации одним вызовом, без дополнительной оплаты. Банк ограничивает доступ без участия пользователя, поэтому вызов может вернуть 429 refresh_limit_reached с заголовком Retry-After. См. Обновление банковских данных по запросу.

Авторизации

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.

Заголовки

Idempotency-Key
string

Необязательный ключ для безопасных повторных запросов, который вы выбираете для одной операции, до 255 символов (подойдёт UUID). Запрос, повторённый с тем же ключом, endpoint, параметрами запроса и телом, получает первый ответ с тем же статусом и тем же телом и не выполняется и не тарифицируется повторно. Тот же ключ с другим endpoint, параметрами запроса или телом возвращает 409 idempotency_key_reused, а пока первый запрос ещё выполняется, 409 idempotency_key_in_progress с Retry-After. Неудачный запрос (любой 4xx или 5xx) не сохраняется, поэтому его можно отправить повторно с тем же ключом. Ключи принадлежат вашему приложению, независимо от того, вызываете ли вы API с API-ключом или с токеном доступа. См. Повторные попытки и идемпотентность.

Required string length: 1 - 255
Prefer
string

wait=<seconds> удерживает вызов до указанного количества секунд, но не более 25, как wait: true в теле запроса.

Пример:

"wait=25"

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

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

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

Тело

application/json

Необязательное тело запроса на обновление.

wait
boolean
по умолчанию:false

true удерживает вызов до 25 секунд и возвращает 200 с завершенной синхронизацией, так что один запрос отдает актуальные данные. Если банк не ответил за это время, вызов возвращает 202: получите синхронизацию через get_sync_run, используя sync_id, или подпишитесь на bank.sync.completed. bank.data.updated приходит, только если синхронизация сохранила изменения. Заголовок Prefer: wait=<seconds> (до 25) работает так же.

Ответ

Синхронизация завершилась в течение 25 секунд.

Завершённая синхронизация, возвращённая обновлением с wait: запуск синхронизации с его outcome, количество по каждому счёту в results и balances_changed.

id
string<uuid>
обязательно
connection_id
string<uuid>
обязательно
trigger
enum<string>
обязательно
Доступные опции:
initial,
scheduled,
requested
status
enum<string>
обязательно
Доступные опции:
queued,
running,
succeeded,
partial,
failed
started_at
string<date-time> | null
обязательно
finished_at
string<date-time> | null
обязательно
results
object[]
обязательно

Что выполнил запуск, по каждому счёту и ресурсу.

error
object | null
обязательно

Почему запуск завершился ошибкой в целом. null, если запуск не завершился ошибкой. Ошибки отдельных счетов и ресурсов находятся в results.

outcome
enum<string>
обязательно

Как завершилась синхронизация.

Доступные опции:
succeeded,
partial,
failed
balances_changed
boolean
обязательно

Изменился ли какой-либо баланс.

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