Vai al contenuto principale
POST
curl
Elimina molti modelli in una sola chiamata. Fornisci un elenco esplicito di ID oppure delete_all: true, eventualmente limitato dagli stessi filtri di List Biometric Templates.

Corpo della richiesta

delete_all: true senza filtri elimina ogni modello biometrico dell’applicazione e l’operazione non può essere annullata. Esegui prima Count Biometric Templates con gli stessi filtri per verificare quali modelli verranno eliminati.

Esempi

I modelli vengono eliminati uno alla volta; ogni risultato riporta purged o already_purged. Se un archivio biometrico non è disponibile, la chiamata restituisce 503 al primo modello per cui si verifica un errore; i modelli eliminati in precedenza nella stessa richiesta restano eliminati, quello che ha causato l’errore passa a purge_failed (già escluso dalla corrispondenza) e ripetere la richiesta completa l’operazione.

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.

Corpo

application/json
template_uuids
string<uuid>[]

Modelli da eliminare definitivamente. Obbligatorio a meno che delete_all sia true. Gli ID già eliminati vengono segnalati come already_purged.

Minimum array length: 1
delete_all
boolean
predefinito:false

Quando è true, elimina definitivamente ogni modello corrispondente ai filtri sottostanti (tutti i modelli dell'applicazione se non viene specificato alcun filtro). template_uuids viene ignorato. Azione irreversibile.

vendor_data
string

Solo con delete_all: corrispondenza parziale senza distinzione tra maiuscole e minuscole su vendor_data dell'Utente proprietario.

vendor_user_uuid
string<uuid>

Solo con delete_all: corrispondenza esatta sull'Utente proprietario.

status
enum<string>

Solo con delete_all.

Opzioni disponibili:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed
source_type
enum<string>

Solo con delete_all.

Opzioni disponibili:
session_delete,
automatic_retention,
backfill
retained_from
string<date-time>

Solo con delete_all.

retained_to
string<date-time>

Solo con delete_all. Non deve essere antecedente a retained_from.

Risposta

Esiti di eliminazione per modello.

results
object[]
Ultima modifica il 7 novembre 2026