Langsung ke konten utama
POST
Python
API Look Up Users dari Didit memetakan hingga 20.000 pengenal ke pengguna aplikasi Anda dalam satu panggilan, dan memberi tahu Anda pengenal mana yang tidak cocok dengan pengguna mana pun. Gunakan API ini saat Anda memiliki daftar akun, misalnya penerima dari batch pembayaran, akun mitra, atau hasil kueri penipuan, dan Anda perlu mengetahui status verifikasi setiap akun tersebut.

Cara kerjanya

  1. Cari daftar. POST /v3/users/lookup/ dengan identifier Anda. Panggilan ini hanya membaca dan mengembalikan lookup_id, jumlah-jumlahnya, dan identifier yang tidak cocok dengan siapa pun.
  2. Baca penggunanya. Teruskan lookup_id sebagai lookup ke 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:
  • 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 400 dengan code: too_many_identifiers.
  • Pencarian hanya mencakup aplikasi Anda.

Permintaan

Respons

Membaca pengguna yang cocok

  • Pengguna ditampilkan sesuai urutan identifier dalam daftar Anda, dipaginasi dengan limit dan offset. 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, lookup mengembalikan 404 dengan code: 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

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 menerima 403. 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

x-api-key
string
header
wajib

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

application/json
identifiers
string[]
wajib

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
Contoh:

Respons

The lookup was read. Use lookup_id with List users.

lookup_id
string<uuid>
wajib

Pass it as lookup to List users.

requested
integer
wajib

Identifiers read, after blanks and duplicates were removed.

found
integer
wajib

Identifiers that matched at least one user.

not_found
object[]
wajib
expires_at
string<date-time>
wajib

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

Terakhir diubah pada 20 November 2026