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:ID一覧で一括検索
Didit APIで、ベンダーID・DiditユーザーID・メールアドレスを最大20,000件まで1回の呼び出しで照合し、送信した順番どおりにユーザーを返します。
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 | 認証済みメールアドレス | 大文字と小文字を区別しません。1つのメールアドレスが複数のユーザーに一致する場合があり、一致したユーザーはすべて対象になります。 |
- 空の項目は除外され、重複は最初の項目を残して削除されます。
- 1回のリクエストで送信できる項目は最大100,000件です。空の項目と重複を除いた後、識別子が1〜20,000件残っている必要があります。いずれかの上限を超えた場合は、
400とcode: too_many_identifiersを返します。 - 照合はお客様のアプリケーションのみを検索します。
リクエスト
{
"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 | 1人以上のユーザーに一致した識別子です。 |
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でページ分割されます。1つのメールアドレスが複数のユーザーに一致する場合は、アカウントが古い順に並びます。 - 結果は24時間保持され、アプリケーション専用です。その後、
lookupは404とcode: lookup_not_foundを返します。リストを再度送信してください。
照会の結果を取得する
GET /v3/users/lookup/{lookup_id}/ は、照会と同じ本文に加えて identifiers を返します。この一覧は、送信した一覧から空欄と重複を取り除いたもので、送信時の順序を保っています。
照会の有効期限が切れている、存在しない、または別のアプリケーションに属している場合は、404 と code: lookup_not_found で応答します。
エラー
| ステータス | 意味 |
|---|---|
400 | 検証エラーです。送信したエントリーが100,000件を超える場合、または整理後の識別子が20,000件を超える場合は too_many_identifiers が返されます。空のリストの場合は {"identifiers": ["Add at least one identifier."]} が返されます。 |
401 | x-api-key が未指定または無効です。 |
403 | このキーでは、このアプリケーションのユーザーを読み取れません。 |
404 | lookup_not_found: 照会の有効期限が切れている、存在しない、または別のアプリケーションに属している場合に返されます。 |
429 | レート制限を超えました。Retry-After ヘッダーの値に従ってください。 |
権限
APIキーには、ユーザーに対する読み取り権限が必要です。このエンドポイントがデータを変更することはありません。この権限のないキー、または失効したキーで呼び出すと、403が返されます。
キーのスコープは、APIキーごとに設定します。コンソールのロールと権限は、コンソール内でユーザーができる操作を決めるもので、APIトラフィックには評価されません。
コンソールでは、リストを検索するには、ユーザーの読み取り権限のみが必要です。
関連情報
承認
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.