Перейти к основному содержанию
POST
cURL

Авторизации

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.

Тело

multipart/form-data
user_image
file
обязательно

Фотография лица для анализа (например, селфи). Отправьте одну фотографию анфас с четко различимым и хорошо освещенным лицом субъекта. Допустимые расширения: tiff, jpg, jpeg, png, webp (кроме PDF). Максимальный размер загрузки: 5 MB (файлы большего размера отклоняются с кодом 400). Изображения автоматически сжимаются примерно до ~0.3 MB перед обработкой, поэтому сверхвысокое разрешение не повышает точность.

face_liveness_score_decline_threshold
number<float>
по умолчанию:30

Порог проверки живости (0–100). Оценка score проверки живости на уровне или ниже этого значения добавляет предупреждение LOW_LIVENESS_SCORE и отклоняет сессию. Увеличьте его для более строгой защиты от спуфинга; значения вне диапазона 0–100 возвращают 400.

Требуемый диапазон: 0 <= x <= 100
Пример:

30

age_estimation_decline_threshold
integer
по умолчанию:18

Минимально допустимый оценочный возраст в годах. Оценочный возраст ниже этого значения добавляет предупреждение AGE_BELOW_MINIMUM и отклоняет сессию. Укажите 0, чтобы отключить проверку возраста (в этом случае вызов выполняет только проверку живости + оценку возраста без принятия решения на основе возраста).

Требуемый диапазон: 0 <= x <= 100
Пример:

18

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

Когда true, сервис поворачивает входное изображение с шагом 90 градусов (0, 90, 180, 270) и использует ориентацию, обеспечивающую наилучшее обнаружение лица — полезно для мобильных снимков с отсутствующей ориентацией EXIF. Увеличивает задержку, поэтому включайте только в том случае, если вы не можете гарантировать правильную ориентацию изображений.

Пример:

false

save_api_request
boolean
по умолчанию:true

Если true (по умолчанию), сохраняет вызов как сессию типа API — видимую в Business Console, доступную через GET /v3/session/{sessionId}/decision/ по возвращенному request_id, анонсируемую через webhook status.updated, с добавлением обнаруженного лица в индекс лиц вашего приложения. Если false, ничего не сохраняется, а request_id является временным UUID только для сопоставления ответа.

Пример:

true

vendor_data
string

Необязательная непрозрачная строка (ваш внутренний идентификатор пользователя, email, UUID…), сохраняемая в сессии и возвращаемая в ответе. Используйте её для сопоставления вызовов API с вашими собственными записями и для последующей фильтрации сессий.

Пример:

"user-123"

metadata
object

Необязательный объект JSON, сохраняемый вместе с сессией (когда save_api_request=true) и возвращаемый обратно в ответе. В multipart-запросах отправляйте его как строковое поле в формате JSON (например, metadata={"flow":"age-gate"}) — он парсится в объект.

Пример:

Ответ

Оценка возраста и пассивная проверка живости завершены. Поле age_estimation.age_estimation содержит предсказанный моделью возраст в годах для самого крупного обнаруженного лица (null, если лиц не обнаружено); age_estimation.score является оценкой пассивной проверки живости (0–100); status имеет значение Approved, только если warnings пуст. Снимок несовершеннолетнего пользователя или попытка спуфинга по-прежнему возвращают 200 со статусом status: "Declined": проверяйте тело ответа, а не только HTTP-код. При save_api_request=true значение request_id является сохраненным id сессии.

request_id
string<uuid>

Идентификатор сохраненной сессии при save_api_request=true (доступен для использования с GET /v3/session/{sessionId}/decision/); в противном случае это временный корреляционный UUID.

age_estimation
object
vendor_data
string | null

Эхо-значение переданного вами vendor_data или null.

metadata
object | null

Эхо-значение переданного вами объекта metadata или null.

created_at
string<date-time>

Временная метка ISO 8601 (UTC) момента генерации ответа.

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