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"
]
}
'{
"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"
}API de recherche d'utilisateurs : vérifier une liste d'identifiants
Résolvez jusqu’à 20,000 identifiants fournisseur, IDs Didit ou e-mails en un appel avec Didit, et listez les utilisateurs dans l’ordre envoyé.
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"
]
}
'{
"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"
}Fonctionnement
- Lancez la recherche.
POST /v3/users/lookup/avec vos identifiants. L’appel ne fait que lire les données et renvoie unlookup_id, les compteurs et les identifiants qui ne correspondent à aucun utilisateur. - Consultez les utilisateurs. Transmettez le
lookup_idcommelookupà Lister les utilisateurs. La requête ne renvoie que les utilisateurs correspondants, dans l’ordre où vous avez soumis les identifiants.
Règles de correspondance
Chaque identifiant est comparé au sein de votre application, dans l’ordre suivant :| Ordre | Comparé à | Règle |
|---|---|---|
| 1 | vendor_data | Correspondance exacte |
| 2 | ID utilisateur Didit | Un UUID, soit le didit_internal_id de l’utilisateur |
| 3 | E-mail vérifié | Insensible à la casse. Un même e-mail peut correspondre à plusieurs utilisateurs, et tous sont comptés |
- Les entrées vides sont supprimées, et les doublons sont retirés en conservant la première occurrence.
- Une requête envoie au plus 100,000 entrées. Une fois les entrées vides et les doublons supprimés, il doit rester entre 1 et 20,000 identifiants. Le dépassement de l’une ou l’autre limite renvoie
400aveccode: too_many_identifiers. - La recherche ne porte que sur votre application.
Requête
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
Réponse
{
"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"
}
| Champ | Description |
|---|---|
lookup_id | Transmettez-le comme lookup dans Lister les utilisateurs. |
requested | Identifiants lus, après suppression des valeurs vides et des doublons. |
found | Identifiants correspondant à au moins un utilisateur. |
not_found | Identifiants ne correspondant à aucun utilisateur, chacun accompagné de sa position à partir de 1 dans la liste soumise et dédupliquée, afin que vous puissiez corriger la liste à sa source. |
expires_at | Date et heure d’expiration du résultat. |
Lire les utilisateurs correspondants
curl -X GET 'https://verification.didit.me/v3/users/?lookup=b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11&limit=200' \
-H 'x-api-key: YOUR_API_KEY'
- Les utilisateurs sont renvoyés dans l’ordre de leur identifiant dans votre liste, paginés avec
limitetoffset. Lorsqu’un même e-mail correspond à plusieurs utilisateurs, ils sont listés du compte le plus ancien au plus récent. - Le résultat est conservé pendant 24 heures, uniquement pour votre application. Passé ce délai,
lookuprenvoie404aveccode: lookup_not_found: soumettez à nouveau la liste.
Récupérer une recherche
GET /v3/users/lookup/{lookup_id}/ renvoie le même corps que la recherche, avec en plus identifiers : la liste que vous avez soumise, après suppression des valeurs vides et des doublons, dans le même ordre.
Elle renvoie 404 avec code: lookup_not_found lorsque la recherche a expiré, n’existe pas ou appartient à une autre application.
Erreurs
| Statut | Signification |
|---|---|
400 | Erreur de validation : too_many_identifiers si plus de 100,000 entrées sont envoyées ou plus de 20,000 identifiants après nettoyage, ou {"identifiers": ["Add at least one identifier."]} pour une liste vide. |
401 | x-api-key manquant ou invalide. |
403 | La clé ne peut pas lire les utilisateurs de cette application. |
404 | lookup_not_found : la recherche a expiré, n’existe pas ou appartient à une autre application. |
429 | Limite de débit dépassée. Respectez Retry-After. |
Autorisations
La clé API doit disposer de l’accès en lecture aux utilisateurs, et l’endpoint ne modifie jamais de données. Une clé qui ne dispose pas de cet accès, ou une clé révoquée, reçoit403.
Les scopes d’une clé sont définis pour chaque clé dans Clés API ; les rôles et autorisations de la Console déterminent ce qu’une personne peut faire dans la Console et ne sont pas évalués pour le trafic de l’API.
Dans la Console, Rechercher une liste requiert uniquement l’autorisation de lire les utilisateurs.
Liens connexes
Autorisations
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.
Corps
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"]
Réponse
The lookup was read. Use lookup_id with List users.