Passer au contenu principal
POST
curl

Aperçu

Utilisez cet endpoint lorsque vous importez des utilisateurs depuis un autre fournisseur et disposez déjà d’une image de visage fiable pour chaque personne. L’utilisateur reste identifié par votre vendor_data, mais cet endpoint de rattachement de profil utilise didit_internal_id afin que l’utilisateur cible soit sans ambiguïté.
Ceci diffère de Téléverser un visage dans la liste. Le téléversement dans le profil rattache un visage à un utilisateur comme élément probant, pour la détection de doublons et la recherche faciale. Le téléversement dans la liste ajoute un visage à une liste de blocage de type visage afin que les sessions de correspondance ultérieures puissent être refusées.

Endpoint

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

Flux de migration

1

Créer ou retrouver l'utilisateur

Appelez POST /v3/users/create/ pour un nouveau profil, ou GET /v3/users/{vendor_data}/ pour un profil existant.
2

Conserver didit_internal_id

La réponse de l’utilisateur contient didit_internal_id. Continuez à utiliser vendor_data dans votre base de données ; n’utilisez didit_internal_id que pour les endpoints de rattachement de profil.
3

Téléverser le visage

Envoyez une image base64 brute dans le champ image. Le serveur valide le décodage de l’image, sa taille et la détection du visage avant de l’enregistrer.

Exemple

Corps de la requête

Réponse

Validation et limites

  • Maximum 5 visages téléversés manuellement par utilisateur.
  • La taille maximale de l’image après décodage est de 2 Mo.
  • L’image doit être du base64 valide et se décoder en image.
  • L’image doit contenir un visage détectable. Utilisez, si possible, un visage cadré de face et bien éclairé.
  • Le visage téléversé est indexé pour la détection future de doublons et la recherche faciale.
  • Le visage téléversé n’est pas ajouté automatiquement à la liste de blocage.

Lister ou supprimer les visages téléversés

Lister les visages du profil :
Supprimer un visage du profil :

Permissions

Utilisez une clé API de la même application. La clé doit appartenir à une application autorisée à gérer le profil utilisateur cible.

Modes d’échec

  • 400 : base64 invalide, image invalide, aucun visage détectable, image de plus de 2 Mo, ou l’utilisateur possède déjà 5 visages téléversés.
  • 401 : identifiants absents ou invalides.
  • 403 : la clé API est valide mais n’est pas autorisée à gérer ce profil utilisateur.
  • 404 : aucun utilisateur n’existe pour ce didit_internal_id dans l’application.
  • 429 : limite de débit atteinte ; temporisez en utilisant Retry-After.

Liens connexes

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

organization_id
string<uuid>
requis

UUID de l'organisation propriétaire de l'application.

application_id
string<uuid>
requis

UUID de l'application à laquelle appartient le profil utilisateur.

didit_internal_id
string<uuid>
requis

UUID interne de l'utilisateur Didit, renvoyé sous la forme didit_internal_id par GET /v3/users/{vendor_data}/ et POST /v3/users/create/.

Corps

application/json
image
string<byte>
requis

Image faciale JPG ou PNG brute encodée en base64. N'incluez pas le préfixe data:image/...;base64,. Taille maximale décodée : 2 MB.

comment
string
défaut:""

Note optionnelle visible par l'opérateur pour le visage téléversé.

Réponse

Visage téléversé et associé au profil utilisateur.

uuid
string<uuid>
requis

UUID de l'enregistrement de visage de l'utilisateur téléversé.

image_url
string<uri> | null
requis

URL signée pour l'image du visage téléversée.

comment
string | null
requis

Commentaire fourni lors du téléversement du visage.

uploaded_by
string | null
requis

E-mail ou identifiant de l'auteur du téléversement lorsqu'il est disponible.

created_at
string<date-time>
requis

Horodatage du téléversement.

Dernière modification le 7 novembre 2026