मुख्य सामग्री पर जाएं
POST
Python
Didit का Look Up Users API एक ही कॉल में आपके एप्लिकेशन के 20,000 तक पहचानकर्ताओं को उपयोगकर्ताओं से मिलाता है, और यह भी बताता है कि कौन-से पहचानकर्ता किसी भी उपयोगकर्ता से नहीं मिले। जब आपके पास खातों की सूची हो, जैसे किसी भुगतान बैच के प्राप्तकर्ता, किसी साझेदार के खाते, या किसी धोखाधड़ी क्वेरी का परिणाम, और आपको उनमें से हर एक की सत्यापन स्थिति जाननी हो, तब इसका उपयोग करें।

यह कैसे काम करता है

  1. सूची खोजें। अपने पहचानकर्ताओं के साथ POST /v3/users/lookup/ को कॉल करें। यह कॉल केवल पढ़ती है और lookup_id, गिनती और उन पहचानकर्ताओं की सूची लौटाती है जिनसे कोई उपयोगकर्ता मेल नहीं खाया।
  2. उपयोगकर्ता पढ़ें। lookup_id को lookup के रूप में उपयोगकर्ता सूची को पास करें। यह केवल मेल खाने वाले उपयोगकर्ता लौटाती है, उसी क्रम में जिसमें आपने पहचानकर्ता सबमिट किए थे।

मिलान के नियम

हर पहचानकर्ता आपके एप्लिकेशन के भीतर इस क्रम में मिलाया जाता है:
  • खाली प्रविष्टियाँ हटा दी जाती हैं, और डुप्लिकेट हटा दिए जाते हैं, पहली प्रविष्टि रखी जाती है।
  • एक अनुरोध में अधिकतम 100,000 प्रविष्टियाँ भेजी जा सकती हैं। खाली और डुप्लिकेट प्रविष्टियाँ हटाने के बाद 1 से 20,000 पहचानकर्ता बचे रहने चाहिए। इनमें से कोई भी सीमा पार होने पर code: too_many_identifiers के साथ 400 लौटता है।
  • लुकअप केवल आपके एप्लिकेशन में खोजता है।

अनुरोध

रिस्पॉन्स

मिलान किए गए उपयोगकर्ताओं को पढ़ें

  • उपयोगकर्ता आपकी सूची में दिए गए पहचानकर्ता के क्रम में आते हैं, और limit तथा offset से पेजिनेटेड होते हैं। जब एक ईमेल कई उपयोगकर्ताओं से मेल खाता है, तो वे सबसे पुराने खाते को पहले रखते हुए सूचीबद्ध होते हैं।
  • परिणाम केवल आपके एप्लिकेशन के लिए 24 घंटे तक रखा जाता है। उसके बाद lookup code: lookup_not_found के साथ 404 लौटाता है: सूची दोबारा सबमिट करें।

लुकअप दोबारा पढ़ें

GET /v3/users/lookup/{lookup_id}/ लुकअप वाली ही बॉडी लौटाता है, साथ में identifiers भी: यह वह सूची है जो आपने भेजी थी, जिसमें से खाली मान और डुप्लिकेट हटाए जा चुके हैं, और उसका क्रम मूल क्रम में रहता है। यदि लुकअप की समय-सीमा समाप्त हो गई हो, वह मौजूद न हो, या किसी दूसरे एप्लिकेशन का हो, तो यह code: lookup_not_found के साथ 404 लौटाता है।

Errors

अनुमतियाँ

API कुंजी के पास उपयोगकर्ताओं के लिए पढ़ने की अनुमति होनी चाहिए, और यह एंडपॉइंट कभी डेटा नहीं बदलता। बिना इस अनुमति वाली कुंजी, या रद्द की गई कुंजी को 403 मिलता है। कुंजी स्कोप हर कुंजी के लिए API कुंजियाँ में सेट किए जाते हैं। Console की भूमिकाएँ और अनुमतियाँ तय करती हैं कि कोई व्यक्ति Console में क्या कर सकता है, और इन्हें API ट्रैफ़िक के लिए नहीं जाँचा जाता। Console में, सूची देखें के लिए केवल उपयोगकर्ताओं को पढ़ने की अनुमति चाहिए।

संबंधित

प्राधिकरण

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).

अंतिम संशोधन 20 नवंबर 2026