Перейти к основному содержанию
GET
curl
Возвращает один шаблон. Используйте biometric_template_uuid, возвращённый методом Удаление сессии, biometric_template_id при совпадении в результате Поиска по лицу, или идентификатор из списка.
Ответ никогда не содержит изображения, вектора, идентификатора удалённой сессии или идентификационных данных. Все поля описаны в обзоре.

Ошибки

Авторизации

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.

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

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

Идентификатор шаблона, возвращаемый в biometric_template_uuid endpoint'ами удаления сессии, biometric_template_id при совпадении в Поиске по лицу или endpoint'ом списка.

Пример:

"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"

Ответ

Шаблон.

uuid
string<uuid>

Идентификатор шаблона. Генерируется случайным образом; не выводится из удаленной сессии или ее лица.

vendor_user_uuid
string<uuid>

Пользователь-владелец.

vendor_data
string | null

Текущие vendor_data пользователя, вычисляемые при чтении шаблона (никогда не копируются).

source_type
enum<string>

Способ создания шаблона: удаление сессии (через API или Console), окно автоматического хранения данных приложения или инициированное вами фоновое заполнение силами Didit.

Доступные опции:
session_delete,
automatic_retention,
backfill
provenance_reference
string<uuid>

Непрозрачная ссылка, связывающая шаблон с его журналом аудита. Она не является идентификатором удалённой сессии и не может быть сопоставлена с ним.

retention_policy
enum<string>

Политика приложения на момент применения правил хранения данных.

Доступные опции:
delete_with_session,
retain_until_user_deleted
retention_override
boolean | null

Значение retain_face_embeddings, отправленное при удалении, или null, если была применена политика.

retained_at
string<date-time>
expires_at
string<date-time>

Время истечения срока действия шаблона и его автоматического удаления. Задаётся всегда.

retained_by
string | null

Субъект, отдавший распоряжение: ID приложения для API-ключей, ID участника Console для действий в Console или идентификатор service: для автоматического хранения данных. Никогда не является адресом электронной почты.

retained_by_type
enum<string>
Доступные опции:
API_KEY,
CONSOLE_USER,
SYSTEM
instruction_class
enum<string>
Доступные опции:
operational_session_delete,
privacy_erasure
instruction_source
enum<string>
Доступные опции:
api,
console,
automatic_retention,
backfill,
privacy_erasure,
explicit_template_purge,
vendor_user_delete,
expiry,
reconciliation,
migration,
system
instruction_id
string

Параметр instruction_id, отправленный при удалении, или сгенерированный Didit id.

held_out_of_use
boolean

true только во время действия юридического удержания. Удержанный шаблон исключается из всех сопоставлений.

status
enum<string>

В сопоставлении участвуют только шаблоны со статусом active, которые не приостановлены, чей срок expires_at не истёк и чей пользователь всё ещё существует.

Доступные опции:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed,
purged
purged_at
string<date-time> | null
Последнее изменение 7 ноября 2026 г.