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 Pencarian Pengguna: Periksa Daftar ID
Cocokkan hingga 20.000 ID vendor, ID Didit, atau email ke pengguna Anda dalam satu panggilan, dengan urutan hasil sesuai input Anda.
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"
}Cara kerjanya
- Cari daftar.
POST /v3/users/lookup/dengan identifier Anda. Panggilan ini hanya membaca dan mengembalikanlookup_id, jumlah-jumlahnya, dan identifier yang tidak cocok dengan siapa pun. - Baca penggunanya. Teruskan
lookup_idsebagailookupke Daftar pengguna. Endpoint ini hanya mengembalikan pengguna yang cocok, dalam urutan identifier yang Anda kirim.
Aturan pencocokan
Setiap identifier dicocokkan di dalam aplikasi Anda, dengan urutan berikut:| Urutan | Dicocokkan dengan | Aturan |
|---|---|---|
| 1 | vendor_data | Kecocokan persis |
| 2 | ID pengguna Didit | UUID, yaitu didit_internal_id dari pengguna |
| 3 | Email terverifikasi | Tidak peka huruf besar/kecil. Satu email dapat cocok dengan beberapa pengguna, dan semuanya dihitung |
- Entri kosong dihapus, dan duplikat dihapus dengan mempertahankan yang pertama.
- Satu permintaan berisi paling banyak 100,000 entri. Setelah entri kosong dan duplikat dihapus, harus tersisa 1 sampai 20,000 identifier. Jika salah satu batas terlampaui, permintaan mengembalikan
400dengancode: too_many_identifiers. - Pencarian hanya mencakup aplikasi Anda.
Permintaan
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
Respons
{
"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"
}
| Kolom | Deskripsi |
|---|---|
lookup_id | Teruskan sebagai lookup ke Daftar pengguna. |
requested | Identifier yang dibaca, setelah entri kosong dan duplikat dihapus. |
found | Identifier yang cocok dengan setidaknya satu pengguna. |
not_found | Identifier yang tidak cocok dengan pengguna mana pun, masing-masing dengan position berbasis 1 dalam daftar yang dikirim dan sudah dihapus duplikatnya, sehingga Anda dapat memperbaiki daftar di sumbernya. |
expires_at | Kapan hasil tersebut kedaluwarsa. |
Membaca pengguna yang cocok
curl -X GET 'https://verification.didit.me/v3/users/?lookup=b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11&limit=200' \
-H 'x-api-key: YOUR_API_KEY'
- Pengguna ditampilkan sesuai urutan identifier dalam daftar Anda, dipaginasi dengan
limitdanoffset. Jika satu email cocok dengan beberapa pengguna, pengguna tersebut diurutkan berdasarkan usia akun, dengan akun yang paling lama di urutan pertama. - Hasil disimpan selama 24 jam, hanya untuk aplikasi Anda. Setelah itu,
lookupmengembalikan404dengancode: lookup_not_found. Kirimkan ulang daftar tersebut.
Membaca kembali lookup
GET /v3/users/lookup/{lookup_id}/ mengembalikan isi yang sama dengan lookup, ditambah identifiers: daftar yang Anda kirimkan setelah entri kosong dan duplikat dihapus, sesuai urutan.
Endpoint ini merespons 404 dengan code: lookup_not_found jika lookup sudah kedaluwarsa, tidak ada, atau milik aplikasi lain.
Kesalahan
| Status | Arti |
|---|---|
400 | Kesalahan validasi: too_many_identifiers jika lebih dari 100,000 entri dikirim atau lebih dari 20,000 identifier setelah pembersihan, atau {"identifiers": ["Add at least one identifier."]} jika daftar kosong. |
401 | x-api-key tidak ada atau tidak valid. |
403 | Kunci tidak dapat membaca pengguna untuk aplikasi ini. |
404 | lookup_not_found: lookup sudah kedaluwarsa, tidak ada, atau milik aplikasi lain. |
429 | Batas laju terlampaui. Patuhi header Retry-After. |
Izin
Kunci API memerlukan akses read ke pengguna, dan endpoint ini tidak pernah mengubah data. Kunci tanpa akses tersebut, atau kunci yang sudah dicabut, akan menerima403.
Cakupan kunci ditetapkan untuk setiap kunci di API keys. Roles and permissions di Console menentukan apa yang dapat dilakukan seseorang di Console, dan peran serta izin tersebut tidak dievaluasi untuk lalu lintas API.
Di Console, Look up a list hanya memerlukan izin untuk membaca pengguna.
Terkait
Otorisasi
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.
Body
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"]
Respons
The lookup was read. Use lookup_id with List users.