Passer au contenu principal
GET
curl
Renvoie un seul gabarit biométrique. Utilisez le biometric_template_uuid renvoyé par Supprimer une session, le biometric_template_id d’un résultat de recherche faciale, ou un identifiant de la liste.
La réponse n’inclut jamais d’image, de vecteur, d’identifiant de la session supprimée, ni de données d’identité. Consultez la vue d’ensemble pour connaître tous les champs.

Erreurs

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

template_uuid
string<uuid>
requis

Identifiant du modèle, tel que renvoyé dans biometric_template_uuid par les endpoints de suppression de session, biometric_template_id lors d'une correspondance de Recherche faciale, ou l'endpoint de liste.

Exemple:

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

Réponse

Le modèle.

uuid
string<uuid>

Identifiant du modèle. Généré de manière aléatoire ; non dérivé de la session supprimée ou de son visage.

vendor_user_uuid
string<uuid>

L'utilisateur propriétaire.

vendor_data
string | null

Les vendor_data actuelles de l'utilisateur, résolues lorsque vous lisez le modèle (jamais copiées).

source_type
enum<string>

Manière dont le modèle a été créé : suppression d'une session (API ou Console), fenêtre automatique de conservation des données de l'application, ou rétro-remplissage opéré par Didit sur votre instruction.

Options disponibles:
session_delete,
automatic_retention,
backfill
provenance_reference
string<uuid>

Référence opaque liant le modèle à son journal d'audit. Il ne s'agit pas de l'identifiant de la session supprimée et il ne peut pas être résolu vers celui-ci.

retention_policy
enum<string>

La politique de l'application au moment de la conservation.

Options disponibles:
delete_with_session,
retain_until_user_deleted
retention_override
boolean | null

La valeur retain_face_embeddings envoyée lors de la suppression, ou null lorsque la politique s'est appliquée.

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

Moment où le modèle expire et est purgé automatiquement. Toujours défini.

retained_by
string | null

Entité principale ayant donné l'instruction : l'ID d'application pour les clés API, l'ID de membre de la Console pour les actions dans la Console, ou un identifiant service: pour la conservation automatique. Jamais une adresse e-mail.

retained_by_type
enum<string>
Options disponibles:
API_KEY,
CONSOLE_USER,
SYSTEM
instruction_class
enum<string>
Options disponibles:
operational_session_delete,
privacy_erasure
instruction_source
enum<string>
Options disponibles:
api,
console,
automatic_retention,
backfill,
privacy_erasure,
explicit_template_purge,
vendor_user_delete,
expiry,
reconciliation,
migration,
system
instruction_id
string

L'instruction_id envoyé lors de la suppression, ou un identifiant généré par Didit.

held_out_of_use
boolean

true uniquement lorsqu'une obligation légale de conservation (legal hold) s'applique. Un gabarit conservé est exclu de toute mise en correspondance.

status
enum<string>

Seuls les modèles active qui ne sont pas suspendus, dont la date expires_at n'est pas dépassée et dont l'utilisateur existe toujours participent à la correspondance.

Options disponibles:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed,
purged
purged_at
string<date-time> | null
Dernière modification le 7 novembre 2026