الانتقال إلى المحتوى الرئيسي
POST
Python
تربط واجهة API للبحث عن المستخدمين من Didit قائمة تضم حتى 20,000 معرّف بمستخدمي تطبيقك في استدعاء واحد، وتُخبرك بالمعرّفات التي لم تطابق أي مستخدم. استخدمها عندما تملك قائمة بالحسابات، مثل المستفيدين في دفعة تحويلات، أو حسابات أحد الشركاء، أو نتائج استعلام احتيال، وتحتاج إلى حالة التحقق لكل منها.

كيف يعمل

  1. ابحث في القائمة. POST /v3/users/lookup/ مع المعرّفات الخاصة بك. هذا الاستدعاء للقراءة فقط، ويعيد lookup_id والأعداد والمعرّفات التي لم تطابق أي مستخدم.
  2. اقرأ المستخدمين. مرّر lookup_id بوصفه lookup إلى قائمة المستخدمين. يعيد هذا الاستدعاء المستخدمين المطابقين فقط، بالترتيب نفسه الذي أرسلت به المعرّفات.

قواعد المطابقة

تُطابَق كل معرّف داخل تطبيقك، بالترتيب التالي:
  • تُحذف الإدخالات الفارغة، وتُزال التكرارات مع الإبقاء على أول ظهور لكل منها.
  • يرسل الطلب 100,000 إدخال كحد أقصى. بعد حذف الإدخالات الفارغة والمكررة، يجب أن يبقى من 1 إلى 20,000 معرّف. يؤدي تجاوز أيٍّ من الحدّين إلى إرجاع 400 مع code: too_many_identifiers.
  • يقتصر البحث على تطبيقك فقط.

الطلب

الاستجابة

قراءة المستخدمين المطابقين

  • يأتي المستخدمون وفق ترتيب معرّفهم في قائمتك، ويُقسَّمون إلى صفحات باستخدام limit وoffset. عندما يطابق بريد إلكتروني واحد عدة مستخدمين، تُعرض الحسابات من الأقدم إلى الأحدث.
  • تُحفظ النتيجة لمدة 24 ساعة، ولتطبيقك وحده. بعد ذلك، يُرجع lookup الاستجابة 404 مع code: lookup_not_found: أعِد إرسال القائمة.

قراءة عملية بحث سابقة

يعيد GET /v3/users/lookup/{lookup_id}/ المحتوى نفسه الذي تعيده عملية البحث، بالإضافة إلى identifiers، وهي القائمة التي أرسلتها بعد حذف القيم الفارغة والتكرارات، مع الحفاظ على ترتيبها. تُرجع استجابة 404 مع code: lookup_not_found عندما تنتهي صلاحية عملية البحث، أو لا توجد، أو تنتمي إلى تطبيق آخر.

الأخطاء

الأذونات

يحتاج مفتاح API إلى إذن القراءة للمستخدمين، ولا يُغيّر endpoint أي بيانات أبداً. ويُرجع أي مفتاح بدون هذا الإذن، أو أي مفتاح ملغى، الاستجابة 403. تُحدَّد نطاقات المفتاح لكل مفتاح على حدة في مفاتيح API، أما الأدوار والأذونات في لوحة التحكم فتحدد ما يمكن للشخص فعله داخل لوحة التحكم، ولا تُقيَّم في حركة مرور API. في لوحة التحكم، يحتاج البحث عن قائمة إلى إذن قراءة المستخدمين فقط.

ذات صلة

التفويضات

x-api-key
string
header
مطلوب

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.

الجسم

application/json
identifiers
string[]
مطلوب

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.

Maximum array length: 100000
مثال:

الاستجابة

The lookup was read. Use lookup_id with List users.

lookup_id
string<uuid>
مطلوب

Pass it as lookup to List users.

requested
integer
مطلوب

Identifiers read, after blanks and duplicates were removed.

found
integer
مطلوب

Identifiers that matched at least one user.

not_found
object[]
مطلوب
expires_at
string<date-time>
مطلوب

When the result expires (24 hours after the lookup).

آخر تعديل في ٢٠ نوفمبر ٢٠٢٦