Перейти к основному содержанию
POST
curl
Загрузите изображение лица в формате base64 в список блокировки или список разрешённых лиц. Didit находит лица на изображении, сохраняет самое крупное из них, хранит изображение и обрезанное изображение этого лица и вычисляет биометрический шаблон лица, с которым сравниваются новые сессии. Значение value новой записи является UUID этого лица. Доступно только для списков с entry_type: face и list_type: blocklist или list_type: allowlist.
Если вы хотите добавить в список блокировки или список разрешённых лиц лицо из существующей сессии, вместо этого используйте Создать запись с reference_session_id: запись будет связана с сессией.
Изображение должно содержать чётко видимое лицо и не превышать 2 МБ после декодирования. Если лицо не обнаружено, запрос возвращает 400 и запись не создаётся. Если анализ лиц временно недоступен, запрос возвращает 503: повторите попытку позже.
Чтобы удалить лицо из списка, удалите его запись: запись больше не будет сопоставляться с новыми сессиями.

Авторизации

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.

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

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

UUID списка с entry_type: face и list_type: blocklist или allowlist.

Тело

application/json
image
string<byte>
обязательно

Изображение в формате JPEG или PNG в кодировке Base64, размером не более 2 МБ после декодирования, с чётко видимым лицом. Отправляйте чистую строку base64 без префикса data:image/...;base64,.

comment
string
по умолчанию:""

Необязательная текстовая заметка в свободной форме, например причина внесения в список.

Ответ

Запись лица создана.

Одно значение в списке.

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

Идентификатор записи. Используйте его в качестве entry_uuid в запросе «Удалить запись списка».

value
string
обязательно

Значение из списка: номер телефона в формате E.164, адрес электронной почты, номер документа, IP-адрес или диапазон CIDR, цифровой отпечаток устройства, адрес кошелька, банковский счёт, трёхбуквенный код страны по стандарту ISO 3166-1 alpha-3, vendor_data, любая строка в списке типа key или UUID сохранённого лица в списке лиц. Отправляемые вами значения сохраняются в нижнем регистре, за исключением номеров телефонов и кодов стран. Сопоставление нечувствительно к регистру.

display_label
string | null
обязательно

Понятная метка. Didit заполняет её для записей, взятых из сессии (например, имя владельца и номер документа), если вы ничего не передали.

Maximum string length: 512
comment
string
обязательно

Примечание в виде произвольного текста. Пустая строка, если не задано.

added_by
string | null
обязательно

Кто добавил запись: api (API-ключ), адрес электронной почты пользователя консоли или console, system или migration (записи, созданные Didit), либо rule (действие правила транзакций или мониторинга).

reference_session_id
string<uuid> | null
обязательно

Сессия верификации, из которой была взята запись. null, если запись была добавлена по значению.

reference_session_number
integer | null
обязательно

Номер этой сессии в рамках приложения, как он отображается в консоли.

reference_session_type
enum<string> | null
обязательно

kyc для сессии проверки физического лица, kyb для сессии верификации бизнеса, null, если сессия отсутствует.

Доступные опции:
kyc,
kyb,
null
reference_object_uuid
string<uuid> | null
обязательно

Запись, которой соответствует элемент: запись лица, документа, телефона или адреса электронной почты, считанная из сессии, лицо, созданное с помощью «Загрузить лицо в список», или переданный вами UUID (например, UUID транзакции или didit_internal_id пользователя).

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

Дополнительный контекст. Содержит ключи, установленные Didit (перечисленные здесь), объединенные с любыми metadata, переданными вами при создании записи, и возвращается в сохраненном виде. null, если контекст отсутствует.

created_at
string<date-time>
обязательно

Когда запись была добавлена.

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