Saltar para o conteúdo principal
POST
Python
A API Look Up Users da Didit resolve uma lista de até 20 000 identificadores para os utilizadores da sua aplicação numa única chamada e indica quais os identificadores que não correspondem a ninguém. Utilize-a quando tiver uma lista de contas, como os beneficiários de um lote de pagamentos, as contas de um parceiro ou o resultado de uma consulta de fraude, e precisar do estado de verificação de cada uma.

Como funciona

  1. Pesquise a lista. POST /v3/users/lookup/ com os seus identificadores. A chamada apenas lê e responde com um lookup_id, as contagens e os identificadores que não correspondem a nenhum utilizador.
  2. Leia os utilizadores. Passe o lookup_id como lookup para Listar utilizadores. Devolve apenas os utilizadores correspondentes, pela ordem em que você submeteu os identificadores.

Regras de correspondência

Cada identificador é comparado dentro da sua aplicação, por esta ordem:
  • As entradas em branco são eliminadas, e os duplicados são removidos, mantendo a primeira ocorrência.
  • Um pedido envia no máximo 100 000 entradas. Depois de removidas as entradas em branco e os duplicados, têm de restar entre 1 e 20 000 identificadores. Se qualquer um dos limites for excedido, é devolvido 400 com code: too_many_identifiers.
  • A pesquisa é feita apenas na sua aplicação.

Pedido

Resposta

Ler os utilizadores correspondentes

  • Os utilizadores são apresentados pela ordem do respetivo identificador na sua lista, paginados com limit e offset. Quando um e-mail corresponde a vários utilizadores, são listados primeiro os de conta mais antiga.
  • O resultado é mantido durante 24 horas, apenas para a sua aplicação. Depois disso, lookup devolve 404 com code: lookup_not_found: envie a lista novamente.

Ler uma pesquisa

GET /v3/users/lookup/{lookup_id}/ devolve o mesmo corpo de resposta da pesquisa, acrescido de identifiers: a lista que enviou, pela mesma ordem, depois de removidos os valores vazios e os duplicados. Responde com 404 e code: lookup_not_found quando a pesquisa expirou, não existe ou pertence a outra aplicação.

Erros

Permissões

A chave de API precisa de acesso de leitura a utilizadores, e o endpoint nunca altera dados. Uma chave sem este acesso, ou uma chave revogada, recebe 403. Os âmbitos da chave são definidos por chave em Chaves de API. As funções e permissões da Consola decidem o que uma pessoa pode fazer na Consola e não são avaliadas para o tráfego da API. Na Consola, Pesquisar uma lista precisa apenas da permissão para ler utilizadores.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Corpo

application/json
identifiers
string[]
obrigatório

Each entry is a vendor_data value, a Didit user ID or a verified email. Send at most 100,000 entries. Blank entries are dropped and duplicates removed, keeping the first, and at most 20,000 identifiers must remain. Either limit exceeded is a 400 with code: too_many_identifiers, and an empty list is a 400 too.

Maximum array length: 100000
Exemplo:

Resposta

The lookup was read. Use lookup_id with List users.

lookup_id
string<uuid>
obrigatório

Pass it as lookup to List users.

requested
integer
obrigatório

Identifiers read, after blanks and duplicates were removed.

found
integer
obrigatório

Identifiers that matched at least one user.

not_found
object[]
obrigatório
expires_at
string<date-time>
obrigatório

When the result expires (24 hours after the lookup).

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