Saltar al contingut principal
POST
curl
Afegeix a la llista de bloqueig el que una sessió de verificació ha recollit: la cara, el document d’identitat, el número de telèfon o l’adreça de correu electrònic. Didit marca cada registre seleccionat com a bloquejat i l’afegeix a la llista de bloqueig del sistema corresponent, vinculada a la sessió. A partir d’aquest moment, les noves sessions amb una cara, un número de document, un número de telèfon o una adreça de correu electrònic coincidents seran rebutjades.
La crida és tot o res: si la sessió no té cap registre del tipus seleccionat, o si el document no té el seu estat emissor, tipus de document, número de document o nom complet, retorna 400 i no es bloqueja res. Repetir la crida per a un element que ja està bloquejat és segur.
Per consultar què està bloquejat, utilitza Llista d’elements bloquejats. Per aixecar un bloqueig, utilitza Elimina de la llista de bloqueig. Per bloquejar una adreça IP, una empremta de dispositiu, un usuari, una empresa o un valor sense sessió, afegeix una entrada a la llista de bloqueig del sistema corresponent amb Crea una entrada. Consulta Llista de bloqueig d’usuaris per veure com s’apliquen les llistes de bloqueig.

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

Com a mínim un indicador blocklist_* ha de ser true.

session_id
string<uuid>
requerit

Una sessió de verificació de persona de la teva aplicació. Es rebutgen les sessions suprimides.

blocklist_face
boolean
predeterminat:false

Afegir a la llista de bloqueig la cara de la sessió.

blocklist_document
boolean
predeterminat:false

Afegir a la llista de bloqueig el document d'identitat de la sessió. El document necessita el seu estat emissor, tipus de document, número de document i nom complet.

blocklist_phone
boolean
predeterminat:false

Afegir a la llista de bloqueig el número de telèfon de la sessió.

blocklist_email
boolean
predeterminat:false

Afegir a la llista de bloqueig l'adreça de correu electrònic de la sessió.

Resposta

Els elements seleccionats s'han afegit a la llista de bloqueig.

message
string
requerit

Sempre Successfully updated blocklist.

Darrera modificació el 7 de novembre del 2026