Saltar al contingut principal
POST
curl
Purga moltes plantilles en una sola crida. Proporciona una llista d’identificadors explícita o delete_all: true, opcionalment restringida pels mateixos filtres que Llista les plantilles biomètriques.

Cos de la sol·licitud

delete_all: true sense filtres purga totes les plantilles biomètriques de l’aplicació i no es pot desfer. Executa primer Compta les plantilles biomètriques amb els mateixos filtres per confirmar què es purgarà.

Exemples

Les plantilles es purguen una a una; cada resultat indica purged o already_purged. Si un magatzem biomètric no està disponible, la crida retorna 503 a la primera plantilla que falli; les plantilles purgades abans en la mateixa sol·licitud continuen purgades, la que ha fallat passa a purge_failed (ja exclosa de la comparació), i repetir la sol·licitud acaba la feina.

Errors

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json
template_uuids
string<uuid>[]

Plantilles per purgar. Obligatòries tret que delete_all sigui true. Els identificadors ja purgats s'informen com a already_purged.

Minimum array length: 1
delete_all
boolean
predeterminat:false

Quan és true, purga totes les plantilles que coincideixin amb els filtres següents (totes les plantilles de l'aplicació si no s'especifica cap filtre). S'ignora template_uuids. Irreversible.

vendor_data
string

Només amb delete_all: coincidència de subcadena sense distinció entre majúscules i minúscules sobre el vendor_data de l'usuari propietari.

vendor_user_uuid
string<uuid>

Només amb delete_all: coincidència exacta sobre l'usuari propietari.

status
enum<string>

Només amb delete_all.

Opcions disponibles:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed
source_type
enum<string>

Només amb delete_all.

Opcions disponibles:
session_delete,
automatic_retention,
backfill
retained_from
string<date-time>

Només amb delete_all.

retained_to
string<date-time>

Només amb delete_all. No ha de ser anterior a retained_from.

Resposta

Resultats de la purga per plantilla.

results
object[]
Darrera modificació el 7 de novembre del 2026