from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.users.lookup(
identifiers=["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.users.lookup({
identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Users.Lookup(ctx, didit.UsersLookupRequest{
Identifiers: []string{"usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.UsersLookupRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.users().lookup(UsersLookupRequest.builder()
.identifiers(List.of("usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->users->lookup([
'identifiers' => ['usr_8842', 'maria.o@gmail.com', 'f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418', 'usr_7001'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.users.lookup(identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Users.LookupAsync(new UsersLookupRequest
{
Identifiers = new string[] { "usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001" },
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request POST \
--url https://verification.didit.me/v3/users/lookup/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
'API de consulta d'usuaris: comprova una llista d'IDs
Resol fins a 20,000 IDs de proveïdor, IDs d’usuari de Didit o correus electrònics en una sola crida i llista’ls en l’ordre enviat.
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.users.lookup(
identifiers=["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.users.lookup({
identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Users.Lookup(ctx, didit.UsersLookupRequest{
Identifiers: []string{"usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.UsersLookupRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.users().lookup(UsersLookupRequest.builder()
.identifiers(List.of("usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->users->lookup([
'identifiers' => ['usr_8842', 'maria.o@gmail.com', 'f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418', 'usr_7001'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.users.lookup(identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Users.LookupAsync(new UsersLookupRequest
{
Identifiers = new string[] { "usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001" },
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request POST \
--url https://verification.didit.me/v3/users/lookup/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
'Com funciona
- Consulta la llista.
POST /v3/users/lookup/amb els teus identificadors. La crida només llegeix i respon amb unlookup_id, els recomptes i els identificadors que no han coincidit amb cap usuari. - Llegeix els usuaris. Passa el
lookup_idcom alookupa Llista d’usuaris. Retorna només els usuaris coincidents, en l’ordre en què has enviat els identificadors.
Regles de coincidència
Cada identificador es fa coincidir dins de la teva aplicació, en aquest ordre:| Ordre | Coincideix amb | Regla |
|---|---|---|
| 1 | vendor_data | Coincidència exacta |
| 2 | ID d’usuari de Didit | Un UUID, el didit_internal_id de l’usuari |
| 3 | Correu electrònic verificat | Sense distingir majúscules i minúscules. Un mateix correu electrònic pot coincidir amb diversos usuaris, i tots compten |
- Les entrades en blanc s’eliminen, i els duplicats també s’eliminen i es manté el primer.
- Una sol·licitud envia com a màxim 100.000 entrades. Després d’eliminar les entrades en blanc i els duplicats, han de quedar entre 1 i 20.000 identificadors. Si se supera qualsevol dels dos límits, es retorna
400ambcode: too_many_identifiers. - La cerca només busca a la teva aplicació.
Sol·licitud
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
Resposta
{
"lookup_id": "b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11",
"requested": 4,
"found": 3,
"not_found": [{ "identifier": "usr_7001", "position": 4 }],
"expires_at": "2026-11-19T10:30:00Z"
}
| Camp | Descripció |
|---|---|
lookup_id | Passa’l com a lookup a Llistar usuaris. |
requested | Identificadors llegits, després d’eliminar els valors buits i els duplicats. |
found | Identificadors que han coincidit amb almenys un usuari. |
not_found | Els identificadors que no han coincidit amb cap usuari, cadascun amb la seva position (comptada des de 1) a la llista enviada, sense duplicats, perquè puguis corregir la llista a l’origen. |
expires_at | Quan caduca el resultat. |
Llegeix els usuaris coincidents
curl -X GET 'https://verification.didit.me/v3/users/?lookup=b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11&limit=200' \
-H 'x-api-key: YOUR_API_KEY'
- Els usuaris es retornen en l’ordre del seu identificador a la teva llista, paginats amb
limitioffset. Quan un correu electrònic coincideix amb diversos usuaris, es mostren primer els comptes més antics. - El resultat es conserva durant 24 hores, només per a la teva aplicació. Després,
lookupretorna404ambcode: lookup_not_found: envia de nou la llista.
Recuperar una consulta
GET /v3/users/lookup/{lookup_id}/ retorna el mateix cos que la consulta, més identifiers: la llista que has enviat després d’eliminar els espais en blanc i els duplicats, en el mateix ordre.
Respon amb 404 i code: lookup_not_found quan la consulta ha caducat, no existeix o pertany a una altra aplicació.
Errors
| Codi d’estat | Significat |
|---|---|
400 | Error de validació: too_many_identifiers per a més de 100,000 entrades enviades o més de 20,000 identificadors després de la neteja, o {"identifiers": ["Add at least one identifier."]} per a una llista buida. |
401 | Falta la capçalera x-api-key o no és vàlida. |
403 | La clau no pot llegir usuaris d’aquesta aplicació. |
404 | lookup_not_found: la consulta ha caducat, no existeix o pertany a una altra aplicació. |
429 | S’ha superat el límit de freqüència. Respecta Retry-After. |
Permisos
La clau d’API necessita accés de lectura als usuaris, i l’endpoint no modifica mai les dades. Una clau sense aquest accés, o una clau revocada, rep403.
Els àmbits de la clau s’estableixen per clau a Claus d’API; els rols i permisos de la Console decideixen què pot fer una persona a la Console i no s’avaluen per al trànsit de l’API.
A la Console, Consulta una llista només necessita el permís per llegir usuaris.
Relacionats
Autoritzacions
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.
Cos
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.
100000["usr_8842", "maria.o@gmail.com"]
Resposta
The lookup was read. Use lookup_id with List users.