Pular para o conteúdo principal
POST
curl
Adicione à lista de bloqueio os dados coletados em uma sessão de verificação: o rosto, o documento de identidade, o número de telefone ou o endereço de e-mail. A Didit marca cada registro selecionado como bloqueado e o adiciona à lista de bloqueio do sistema correspondente, vinculado à sessão. A partir daí, novas sessões com rosto, número de documento, número de telefone ou endereço de e-mail correspondente são recusadas.
A chamada é do tipo tudo ou nada: se a sessão não tiver registro de um tipo selecionado, ou se faltar ao documento o estado emissor, o tipo de documento, o número do documento ou o nome completo, ela retorna 400 e nada é adicionado à lista de bloqueio. Repetir a chamada para um item que já está na lista de bloqueio é seguro.
Para verificar o que está bloqueado, use Listar itens bloqueados. Para remover um bloqueio, use Remover da lista de bloqueio. Para bloquear um endereço IP, uma impressão digital de dispositivo, um usuário, uma empresa ou um valor sem sessão, adicione uma entrada à lista de bloqueio do sistema correspondente com Criar entrada. Consulte Lista de bloqueio de usuários para saber como as listas de bloqueio são aplicadas.

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json

Pelo menos uma flag blocklist_* deve ser true.

session_id
string<uuid>
obrigatório

Uma sessão de verificação de pessoa da sua aplicação. Sessões excluídas são recusadas.

blocklist_face
boolean
padrão:false

Adicionar o rosto da sessão à lista de bloqueio.

blocklist_document
boolean
padrão:false

Adicionar o documento de identidade da sessão à lista de bloqueio. O documento precisa ter o estado emissor, o tipo de documento, o número do documento e o nome completo.

blocklist_phone
boolean
padrão:false

Adicionar o número de telefone da sessão à lista de bloqueio.

blocklist_email
boolean
padrão:false

Adicionar o endereço de e-mail da sessão à lista de bloqueio.

Resposta

Os itens selecionados foram adicionados à lista de bloqueio.

message
string
obrigatório

Sempre Successfully updated blocklist.

Última modificação em 1 de novembro de 2026