Saltar al contenido principal
POST
curl
Añade a la lista de bloqueo lo que recopiló una sesión de verificación: su rostro, su documento de identidad, su número de teléfono o su dirección de correo electrónico. Didit marca cada registro seleccionado como bloqueado y lo añade a la lista de bloqueo del sistema correspondiente, vinculada a la sesión. A partir de ese momento, se rechazan las nuevas sesiones con un rostro, número de documento, número de teléfono o dirección de correo electrónico coincidentes.
La llamada es de todo o nada: si la sesión no tiene ningún registro de un tipo seleccionado, o si al documento le falta el estado de emisión, el tipo de documento, el número de documento o el nombre completo, devuelve 400 y no se bloquea nada. Repetir la llamada para un elemento que ya está en la lista de bloqueo es seguro.
Para comprobar qué está bloqueado, usa Listar elementos bloqueados. Para levantar un bloqueo, usa Eliminar de la lista de bloqueo. Para bloquear una dirección IP, una huella digital de dispositivo, un usuario, una empresa o un valor sin sesión, añade una entrada a la lista de bloqueo del sistema correspondiente con Crear entrada. Consulta Lista de bloqueo de usuarios para saber cómo se aplican las listas de bloqueo.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json

Al menos un indicador blocklist_* debe ser true.

session_id
string<uuid>
requerido

Una sesión de verificación de persona de tu aplicación. Se rechazan las sesiones eliminadas.

blocklist_face
boolean
predeterminado:false

Añadir a la lista de bloqueo el rostro de la sesión.

blocklist_document
boolean
predeterminado:false

Añadir a la lista de bloqueo el documento de identidad de la sesión. El documento debe tener su estado emisor, el tipo de documento, el número de documento y el nombre completo.

blocklist_phone
boolean
predeterminado:false

Añadir a la lista de bloqueo el número de teléfono de la sesión.

blocklist_email
boolean
predeterminado:false

Añadir a la lista de bloqueo la dirección de correo electrónico de la sesión.

Respuesta

Los elementos seleccionados se añadieron a la lista de bloqueo.

message
string
requerido

Siempre Successfully updated blocklist.

Última modificación el 1 de noviembre de 2026