Saltar para o conteúdo principal
POST
curl
Coloque na lista de bloqueio o que uma sessão de verificação recolheu: o rosto, o documento de identidade, o número de telefone ou o endereço de e-mail. A Didit marca cada registo selecionado como bloqueado e adiciona-o à lista de bloqueio do sistema correspondente, ligado à sessão. A partir desse momento, as novas sessões com um rosto, número de documento, número de telefone ou endereço de e-mail correspondente são recusadas.
A chamada é tudo ou nada: se a sessão não tiver nenhum registo do tipo selecionado, ou se o documento não tiver estado emissor, tipo de documento, número do documento ou nome completo, a API devolve 400 e nada é bloqueado. Repetir a chamada para um item já bloqueado é seguro.
Para verificar o que está bloqueado, use Listar itens bloqueados. Para levantar um bloqueio, use Remover da lista de bloqueio. Para bloquear um endereço IP, uma impressão digital de dispositivo, um utilizador, 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 utilizadores para saber como as listas de bloqueio são aplicadas.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json

Pelo menos um indicador blocklist_* tem de ser true.

session_id
string<uuid>
obrigatório

Uma sessão de verificação de pessoa da sua aplicação. As sessões eliminadas são recusadas.

blocklist_face
boolean
padrão:false

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

blocklist_document
boolean
padrão:false

Adicionar à lista de bloqueio o documento de identificação da sessão. O documento necessita do seu estado emissor, tipo de documento, número de documento e nome completo.

blocklist_phone
boolean
padrão:false

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

blocklist_email
boolean
padrão:false

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

Resposta

Os itens selecionados foram adicionados à lista de bloqueio.

message
string
obrigatório

Sempre Successfully updated blocklist.

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