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: आईडी की सूची जाँचें
Didit के साथ एक कॉल में 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 उपयोगकर्ता ID | एक UUID, यानी उपयोगकर्ता का didit_internal_id |
| 3 | सत्यापित ईमेल | अक्षर-आकार (केस) पर ध्यान नहीं दिया जाता। एक ईमेल कई उपयोगकर्ताओं से मेल खा सकता है, और उन सभी की गिनती होती है। |
- खाली प्रविष्टियाँ हटा दी जाती हैं, और डुप्लिकेट हटा दिए जाते हैं, पहली प्रविष्टि रखी जाती है।
- एक अनुरोध में अधिकतम 100,000 प्रविष्टियाँ भेजी जा सकती हैं। खाली और डुप्लिकेट प्रविष्टियाँ हटाने के बाद 1 से 20,000 पहचानकर्ता बचे रहने चाहिए। इनमें से कोई भी सीमा पार होने पर
code: too_many_identifiersके साथ400लौटता है। - लुकअप केवल आपके एप्लिकेशन में खोजता है।
अनुरोध
{
"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 | वे पहचानकर्ता जिनका किसी भी उपयोगकर्ता से मिलान नहीं हुआ। प्रत्येक के साथ सबमिट की गई, डुप्लिकेट-रहित सूची में उसकी 1-आधारित position दी गई है, ताकि आप सूची को उसके स्रोत पर ठीक कर सकें। |
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 घंटे तक रखा जाता है। उसके बाद
lookupcode: lookup_not_foundके साथ404लौटाता है: सूची दोबारा सबमिट करें।
लुकअप दोबारा पढ़ें
GET /v3/users/lookup/{lookup_id}/ लुकअप वाली ही बॉडी लौटाता है, साथ में identifiers भी: यह वह सूची है जो आपने भेजी थी, जिसमें से खाली मान और डुप्लिकेट हटाए जा चुके हैं, और उसका क्रम मूल क्रम में रहता है। यदि लुकअप की समय-सीमा समाप्त हो गई हो, वह मौजूद न हो, या किसी दूसरे एप्लिकेशन का हो, तो यह code: lookup_not_found के साथ 404 लौटाता है।
Errors
| Status | Meaning |
|---|---|
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 कुंजी के पास उपयोगकर्ताओं के लिए पढ़ने की अनुमति होनी चाहिए, और यह एंडपॉइंट कभी डेटा नहीं बदलता। बिना इस अनुमति वाली कुंजी, या रद्द की गई कुंजी को403 मिलता है।
कुंजी स्कोप हर कुंजी के लिए API कुंजियाँ में सेट किए जाते हैं। Console की भूमिकाएँ और अनुमतियाँ तय करती हैं कि कोई व्यक्ति Console में क्या कर सकता है, और इन्हें API ट्रैफ़िक के लिए नहीं जाँचा जाता।
Console में, सूची देखें के लिए केवल उपयोगकर्ताओं को पढ़ने की अनुमति चाहिए।
संबंधित
प्राधिकरण
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.