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

Обзор

Используйте этот endpoint, когда импортируете пользователей от другого провайдера и уже располагаете доверенным изображением лица для каждого человека. Пользователь по-прежнему определяется вашим vendor_data, но этот endpoint прикрепления профиля использует didit_internal_id, чтобы целевой пользователь определялся однозначно.
Это отличается от загрузки лица в список. Загрузка в профиль прикрепляет лицо к пользователю для использования в качестве подтверждения, обнаружения дубликатов и поиска по лицу. Загрузка в список добавляет лицо в список блокировки по лицам, чтобы будущие сессии сопоставления можно было отклонять.

Endpoint

POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

Процесс миграции

1

Создание или поиск пользователя

Вызовите POST /v3/users/create/ для нового профиля или GET /v3/users/{vendor_data}/ для существующего.
2

Сохранение didit_internal_id

Ответ с данными пользователя содержит didit_internal_id. Продолжайте использовать vendor_data в своей базе данных, а didit_internal_id применяйте только в endpoints прикрепления профиля.
3

Загрузка лица

Отправьте необработанную строку base64 с изображением в поле image. Перед сохранением бэкенд проверяет декодирование изображения, его размер и обнаружение лица.

Пример

Тело запроса

Ответ

Проверки и ограничения

  • Не более 5 лиц, загруженных вручную, на одного пользователя.
  • Максимальный размер декодированного изображения: 2 МБ.
  • Изображение должно быть корректной строкой base64 и декодироваться как изображение.
  • На изображении должно быть обнаруживаемое лицо. По возможности используйте кадрированный снимок лица анфас при хорошем освещении.
  • Загруженное лицо индексируется для последующего обнаружения дубликатов и поиска по лицу.
  • Загруженное лицо автоматически не добавляется в список блокировки.

Просмотр и удаление загруженных лиц

Получить список лиц профиля:
Удалить одно лицо профиля:

Разрешения

Используйте API-ключ для того же приложения. Ключ должен принадлежать приложению, которому разрешено управлять профилем целевого пользователя.

Сбои

  • 400: неверный base64, неверное изображение, лицо не обнаружено, изображение больше 2 МБ или у пользователя уже 5 загруженных лиц.
  • 401: учетные данные отсутствуют или недействительны.
  • 403: API-ключ действителен, но не имеет права управлять этим профилем пользователя.
  • 404: в приложении нет пользователя с таким didit_internal_id.
  • 429: превышен лимит запросов; повторите запрос позже, используя Retry-After.

Связанные материалы

Авторизации

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.

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

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

UUID организации, владеющей приложением.

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

UUID приложения, которому принадлежит профиль пользователя.

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

Внутренний UUID пользователя Didit, возвращаемый как didit_internal_id методами GET /v3/users/{vendor_data}/ и POST /v3/users/create/.

Тело

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

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

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

Необязательная видимая оператору заметка для загруженного лица.

Ответ

Лицо загружено и прикреплено к профилю пользователя.

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

UUID загруженной записи лица пользователя.

image_url
string<uri> | null
обязательно

Подписанный URL для загруженного изображения лица.

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

Комментарий, указанный при загрузке лица.

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

Электронная почта или идентификатор пользователя, выполнившего загрузку, если доступны.

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

Временная метка загрузки.

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