Перейти к основному содержанию
POST
curl
Выполняет пакетную очистку многих шаблонов за один вызов. Укажите либо явный список идентификаторов, либо delete_all: true, при необходимости сузив выборку теми же фильтрами, что и в списке биометрических шаблонов.

Тело запроса

delete_all: true без фильтров очищает все биометрические шаблоны в приложении, и это действие нельзя отменить. Сначала выполните Подсчёт биометрических шаблонов с теми же фильтрами, чтобы убедиться, что именно будет очищено.

Примеры

Шаблоны очищаются по одному; каждый результат содержит purged или already_purged. Если биометрическое хранилище недоступно, вызов возвращает 503 на первом шаблоне, который не удалось очистить. Шаблоны, очищенные раньше в том же запросе, остаются очищенными, а проблемный шаблон переходит в purge_failed (уже исключён из сопоставления). Повторный запрос завершит очистку.

Ошибки

Авторизации

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

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

Тело

application/json
template_uuids
string<uuid>[]

Шаблоны для безвозвратного удаления. Обязательно, если delete_all не равен true. Уже удаленные идентификаторы возвращаются как already_purged.

Minimum array length: 1
delete_all
boolean
по умолчанию:false

Когда true, безвозвратно удаляет все шаблоны, соответствующие указанным ниже фильтрам (все шаблоны приложения, если фильтр не задан). Параметр template_uuids игнорируется. Действие необратимо.

vendor_data
string

Только с delete_all: нечувствительное к регистру сопоставление по подстроке в vendor_data пользователя-владельца.

vendor_user_uuid
string<uuid>

Только с delete_all: точное совпадение по пользователю-владельцу.

status
enum<string>

Только с delete_all.

Доступные опции:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed
source_type
enum<string>

Только с delete_all.

Доступные опции:
session_delete,
automatic_retention,
backfill
retained_from
string<date-time>

Только с delete_all.

retained_to
string<date-time>

Только с delete_all. Не должно быть раньше retained_from.

Ответ

Результаты очистки по шаблонам.

results
object[]
Последнее изменение 7 ноября 2026 г.