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 поиска пользователей: проверка списка ID
Найдите до 20,000 пользователей Didit по vendor ID, ID или email за один вызов и получите их в исходном порядке.
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"
}Как это работает
- Выполните поиск. Вызовите
POST /v3/users/lookup/с вашими идентификаторами. Вызов только читает данные и возвращаетlookup_id, количества и идентификаторы, которые не совпали ни с одним пользователем. - Получите пользователей. Передайте
lookup_idкакlookupв вызове Список пользователей. Он возвращает только совпавших пользователей, в том порядке, в котором вы передали идентификаторы.
Правила сопоставления
Каждый идентификатор сопоставляется внутри вашего приложения в следующем порядке:| Порядок | Сопоставляется с | Правило |
|---|---|---|
| 1 | vendor_data | Точное совпадение |
| 2 | Идентификатор пользователя Didit | UUID, то есть didit_internal_id пользователя |
| 3 | Подтверждённая электронная почта | Без учёта регистра. Одна почта может совпасть с несколькими пользователями, и все они учитываются |
- Пустые записи удаляются, а из дубликатов сохраняется первая запись.
- Один запрос содержит не более 100,000 записей. После удаления пустых записей и дубликатов должно остаться от 1 до 20,000 идентификаторов. Превышение любого из лимитов возвращает
400сcode: too_many_identifiers. - Поиск выполняется только по вашему приложению.
Запрос
{
"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"
}
| Поле | Описание |
|---|---|
lookup_id | Передайте его как lookup в Список пользователей. |
requested | Идентификаторы, которые были прочитаны после удаления пустых значений и дубликатов. |
found | Идентификаторы, которым соответствует хотя бы один пользователь. |
not_found | Идентификаторы, которым не соответствует ни один пользователь. Для каждого указана его position с нумерацией от 1 в отправленном списке без дубликатов, чтобы вы могли исправить список в источнике. |
expires_at | Когда истекает срок действия результата. |
Получение найденных пользователей
curl -X GET 'https://verification.didit.me/v3/users/?lookup=b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11&limit=200' \
-H 'x-api-key: YOUR_API_KEY'
- Пользователи возвращаются в порядке их идентификаторов в вашем списке, с постраничным выводом через
limitиoffset. Если один адрес электронной почты совпадает с несколькими пользователями, они перечисляются от самой старой учётной записи к самой новой. - Результат хранится 24 часа и доступен только вашему приложению. По истечении этого срока
lookupвозвращает404сcode: lookup_not_found: отправьте список повторно.
Повторное получение результата поиска
GET /v3/users/lookup/{lookup_id}/ возвращает то же тело, что и поиск, а также identifiers: список, который вы отправили, после удаления пустых значений и дубликатов, в исходном порядке.
Если поиск истёк, не существует или принадлежит другому приложению, эндпоинт отвечает 404 с code: lookup_not_found.
Ошибки
| Статус | Значение |
|---|---|
400 | Ошибка валидации: too_many_identifiers, если отправлено более 100,000 записей или более 20,000 идентификаторов после очистки, либо {"identifiers": ["Add at least one identifier."]}, если список пуст. |
401 | Отсутствует или недействителен x-api-key. |
403 | С помощью ключа нельзя читать данные пользователей этого приложения. |
404 | lookup_not_found: срок действия поиска истёк, поиск не существует или принадлежит другому приложению. |
429 | Превышен лимит запросов. Соблюдайте Retry-After. |
Разрешения
Для API-ключа нужен доступ на чтение пользователей, а endpoint никогда не изменяет данные. Ключ без этого доступа или отозванный ключ получает403.
Области доступа ключа задаются для каждого ключа в разделе API-ключи. Роли и разрешения в Консоли определяют, что может делать конкретный человек в Консоли, и для трафика API не проверяются.
В Консоли для поиска в списке достаточно разрешения на чтение пользователей.
Связанные материалы
Авторизации
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.
Тело
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"]
Ответ
The lookup was read. Use lookup_id with List users.