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: التحقق من قائمة المعرّفات
استعلم عن حتى 20,000 معرّف بائع أو معرّف مستخدم في Didit أو بريد إلكتروني في طلب واحد، وأعد المستخدمين بالترتيب الذي أرسلته.
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 | لا يمكن لمفتاح API هذا قراءة المستخدمين لهذا التطبيق. |
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.