Vai al contenuto principale
GET
curl
Restituisce un solo modello. Usa il biometric_template_uuid restituito da Elimina sessione, il biometric_template_id di una corrispondenza di Ricerca facciale, oppure un ID dall’elenco.
La risposta non include mai un’immagine, un vettore, l’ID della sessione eliminata o dati di identità. Consulta la panoramica per tutti i campi.

Errori

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

template_uuid
string<uuid>
obbligatorio

ID del modello, restituito come biometric_template_uuid dagli endpoint di eliminazione della sessione, biometric_template_id in una corrispondenza di Ricerca facciale o dall'endpoint di elenco.

Esempio:

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

Risposta

Il modello.

uuid
string<uuid>

ID del modello. Generato casualmente; non derivato dalla sessione eliminata o dal relativo volto.

vendor_user_uuid
string<uuid>

L'Utente proprietario.

vendor_data
string | null

Il vendor_data corrente dell'Utente, risolto al momento della lettura del modello (mai copiato).

source_type
enum<string>

Come è stato creato il modello: l'eliminazione di una sessione (API o Console), la finestra di conservazione dei dati automatica dell'applicazione o un backfill gestito da Didit su tua istruzione.

Opzioni disponibili:
session_delete,
automatic_retention,
backfill
provenance_reference
string<uuid>

Riferimento opaco che collega il modello al suo registro di audit. Non è l'ID della sessione eliminata e non può essere ricondotto ad esso.

retention_policy
enum<string>

La policy dell'applicazione al momento della conservazione dei dati.

Opzioni disponibili:
delete_with_session,
retain_until_user_deleted
retention_override
boolean | null

Il valore retain_face_embeddings inviato all'eliminazione, oppure null quando è stata applicata la policy.

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

Quando il modello scade e viene eliminato automaticamente. Sempre impostato.

retained_by
string | null

Soggetto che ha impartito l'istruzione: l'ID applicazione per le chiavi API, l'ID membro della Console per le azioni della Console, oppure un identificatore service: per la conservazione automatica. Mai un indirizzo email.

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

L'instruction_id inviato all'eliminazione, oppure un id generato da Didit.

held_out_of_use
boolean

true solo quando si applica un vincolo di conservazione legale. Un modello soggetto a tale vincolo è escluso da qualsiasi corrispondenza.

status
enum<string>

Partecipano al confronto solo i modelli active che non sono sospesi, non hanno superato expires_at e il cui utente esiste ancora.

Opzioni disponibili:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed,
purged
purged_at
string<date-time> | null
Ultima modifica il 7 novembre 2026