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"
}Benutzer abfragen API: Liste von IDs prüfen
Bis zu 20,000 Vendor-IDs, Didit-IDs oder E-Mails in einem Aufruf Benutzern zuordnen und genau diese Benutzer in Ihrer Reihenfolge mit Didit abrufen.
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"
}So funktioniert es
- Liste abfragen.
POST /v3/users/lookup/mit Ihren Kennungen. Der Aufruf liest nur und liefert einelookup_id, die Anzahlen sowie die Kennungen, denen kein Benutzer zugeordnet wurde. - Benutzer abrufen. Übergeben Sie die
lookup_idalslookupan Benutzer auflisten. Es werden nur die übereinstimmenden Benutzer zurückgegeben, und zwar in der Reihenfolge, in der Sie die Kennungen übermittelt haben.
Abgleichsregeln
Jede Kennung wird innerhalb Ihrer Anwendung in dieser Reihenfolge abgeglichen:| Reihenfolge | Abgeglichen mit | Regel |
|---|---|---|
| 1 | vendor_data | Exakte Übereinstimmung |
| 2 | Didit-Benutzer-ID | Eine UUID, die didit_internal_id des Benutzers ist |
| 3 | Verifizierte E-Mail-Adresse | Groß- und Kleinschreibung wird nicht beachtet. Eine E-Mail-Adresse kann mehreren Benutzern zugeordnet sein, und alle diese Benutzer zählen. |
- Leere Einträge werden verworfen. Doppelte Einträge werden entfernt, wobei das erste Vorkommen erhalten bleibt.
- Eine Anfrage darf höchstens 100.000 Einträge enthalten. Nachdem leere Einträge und Duplikate entfernt wurden, müssen zwischen 1 und 20.000 Kennungen übrig bleiben. Wird eines der beiden Limits überschritten, gibt die Anfrage
400mitcode: too_many_identifierszurück. - Die Suche erfolgt ausschließlich in Ihrer Anwendung.
Anfrage
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
Antwort
{
"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"
}
| Feld | Beschreibung |
|---|---|
lookup_id | Übergeben Sie sie als lookup an Benutzer auflisten. |
requested | Die gelesenen Kennungen, nachdem leere Einträge und Duplikate entfernt wurden. |
found | Kennungen, die mindestens einem Benutzer entsprechen. |
not_found | Die Kennungen, denen kein Benutzer entspricht, jeweils mit ihrer 1-basierten position in der übermittelten, deduplizierten Liste, damit Sie die Liste an der Quelle korrigieren können. |
expires_at | Zeitpunkt, zu dem das Ergebnis abläuft. |
Die gefundenen Benutzer abrufen
curl -X GET 'https://verification.didit.me/v3/users/?lookup=b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11&limit=200' \
-H 'x-api-key: YOUR_API_KEY'
- Benutzer werden in der Reihenfolge ihrer Kennung in Ihrer Liste zurückgegeben und mit
limitundoffsetpaginiert. Wenn eine E-Mail-Adresse mehreren Benutzern zugeordnet ist, werden diese nach Kontoalter aufsteigend aufgelistet, das älteste Konto zuerst. - Das Ergebnis wird 24 Stunden lang nur für Ihre Anwendung aufbewahrt. Danach gibt
lookup404mitcode: lookup_not_foundzurück: Senden Sie die Liste erneut.
Einen Lookup abrufen
GET /v3/users/lookup/{lookup_id}/ gibt denselben Antworttext zurück wie der Lookup, zusätzlich identifiers: die Liste, die Sie übermittelt haben, nachdem leere Einträge und Duplikate entfernt wurden, in der übermittelten Reihenfolge.
Der Endpoint antwortet mit 404 und code: lookup_not_found, wenn der Lookup abgelaufen ist, nicht existiert oder zu einer anderen Anwendung gehört.
Errors
| Status | Bedeutung |
|---|---|
400 | Validierungsfehler: too_many_identifiers bei mehr als 100.000 übermittelten Einträgen oder mehr als 20.000 Identifikatoren nach der Bereinigung, oder {"identifiers": ["Add at least one identifier."]} bei einer leeren Liste. |
401 | Fehlender oder ungültiger x-api-key. |
403 | Der API-Schlüssel darf für diese Anwendung keine Benutzer lesen. |
404 | lookup_not_found: Das Lookup ist abgelaufen, existiert nicht oder gehört zu einer anderen Anwendung. |
429 | Rate-Limit überschritten. Beachten Sie den Retry-After-Header. |
Berechtigungen
Der API-Schlüssel benötigt Lesezugriff auf Benutzer, und der Endpoint ändert niemals Daten. Ein Schlüssel ohne diese Berechtigung oder ein widerrufener Schlüssel erhält403.
Die Scopes eines Schlüssels werden pro Schlüssel in den API-Schlüsseln festgelegt. Die Rollen und Berechtigungen der Console bestimmen, was eine Person in der Console tun darf, und werden für API-Anfragen nicht geprüft.
In der Console benötigt Liste abfragen nur die Berechtigung, Benutzer zu lesen.
Verwandte Themen
Autorisierungen
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.
Body
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"]
Antwort
The lookup was read. Use lookup_id with List users.