Saltar al contingut principal
POST
curl
Puja una imatge facial codificada en base64 a una llista de bloqueig o de permesos de cares. Didit detecta les cares de la imatge, en conserva la més gran, emmagatzema la imatge i un retall d’aquesta cara, i calcula la plantilla biomètrica facial amb què es compararan les noves sessions. El value de la nova entrada és l’UUID d’aquesta cara. Només disponible per a llistes amb entry_type: face i list_type: blocklist o list_type: allowlist.
Si vols posar a la llista de bloqueig o de permesos una cara d’una sessió existent, fes servir Crea una entrada amb reference_session_id: l’entrada queda enllaçada amb la sessió.
La imatge ha de contenir una cara clarament visible i no pot superar els 2 MB una vegada descodificada. Si no es detecta cap cara, la sol·licitud retorna 400 i no es crea cap entrada. Si l’anàlisi facial no està disponible temporalment, retorna 503: torna-ho a intentar més tard.
Per eliminar la cara de la llista, elimina’n l’entrada: la cara deixa de coincidir amb les noves sessions.

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.

Paràmetres de ruta

list_uuid
string<uuid>
requerit

UUID d'una llista amb entry_type: face i list_type: blocklist o allowlist.

Cos

application/json
image
string<byte>
requerit

JPEG o PNG codificat en base64, de 2 MB com a màxim un cop descodificat, que mostri una cara clarament visible. Envia la cadena base64 sola, sense el prefix data:image/...;base64,.

comment
string
predeterminat:""

Nota opcional en text lliure, com ara el motiu de la inclusió a la llista.

Resposta

L'entrada de cara s'ha creat.

Un valor en una llista.

uuid
string<uuid>
requerit

Identificador de l'entrada. Utilitza'l com a entry_uuid a l'operació «Eliminar una entrada de llista».

value
string
requerit

El valor llistat: un número de telèfon en E.164, una adreça de correu electrònic, un número de document, una adreça IP o rang CIDR, una empremta digital de dispositiu, una adreça de cartera, un compte bancari, un codi de país ISO 3166-1 alfa-3, un vendor_data, qualsevol cadena en una llista key, o l'UUID de la cara emmagatzemada en una llista de cares. Els valors que envies s'emmagatzemen en minúscules, excepte els números de telèfon i els codis de país. La coincidència no distingeix entre majúscules i minúscules.

display_label
string | null
requerit

Etiqueta fàcil de llegir. Didit l'emplena per a entrades extretes d'una sessió (per exemple, el nom del titular i el número de document) quan no n'envies cap.

Maximum string length: 512
comment
string
requerit

Nota de text lliure. Cadena buida si no s'ha definit.

added_by
string | null
requerit

Qui ha afegit l'entrada: api (una clau d'API), l'adreça de correu electrònic d'un usuari de la consola o console, system o migration (entrades creades per Didit) o rule (una acció de regla de transacció o de monitoratge).

reference_session_id
string<uuid> | null
requerit

Sessió de verificació d'on s'ha extret l'entrada. null quan l'entrada s'ha afegit per valor.

reference_session_number
integer | null
requerit

Número d'aquesta sessió en l'àmbit de l'aplicació, tal com es mostra a la consola.

reference_session_type
enum<string> | null
requerit

kyc per a una sessió de verificació de persona, kyb per a una sessió de verificació d'empresa, null quan no hi ha cap sessió.

Opcions disponibles:
kyc,
kyb,
null
reference_object_uuid
string<uuid> | null
requerit

El registre que representa l'entrada: el registre de rostre, document, telèfon o correu electrònic llegit d'una sessió, el rostre creat per Upload a face to a list, o l'UUID que has enviat (per exemple, un UUID de transacció o el didit_internal_id d'un usuari).

metadata
object | null
requerit

Context addicional. Conté les claus que estableix Didit (llistades aquí) combinades amb qualsevol metadata que hagis enviat en crear l'entrada, retornades tal com s'han desat. null quan no n'hi ha cap.

created_at
string<date-time>
requerit

Quan es va afegir l'entrada.

Darrera modificació el 7 de novembre del 2026