Перейти к основному содержанию
DELETE
curl
endpoint Didit для удаления подключения к банку прекращает доступ к банку и удаляет сохранённые для этого подключения счета, балансы и транзакции. Удаление необратимо. Чтобы прекратить доступ без удаления, используйте функцию отзыва. См. Данные, согласие и удаление, чтобы узнать, что затрагивается, а что нет.

Авторизации

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

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

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

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

Ответ

Удаление принято.

Принято удаление. Банковские данные подключения удаляются, а операции с данными возвращают 409 connection_not_active. При чтении подключения возвращается минимальная запись с этим статусом erasure.

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

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

erasure
object
обязательно

Ход удаления, которое вы запросили.

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