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로 vendor ID, Didit 사용자 ID 또는 이메일 최대 20,000개를 한 번의 호출로 사용자에 매칭하고, 보낸 순서대로 해당 사용자를 나열합니다.
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개 사이의 식별자가 남아 있어야 합니다. 두 한도 중 하나라도 초과하면
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 | 하나 이상의 사용자와 일치한 식별자입니다. |
not_found | 일치하는 사용자가 없었던 식별자입니다. 각 항목에는 제출되고 중복이 제거된 목록에서의 1부터 시작하는 position이 함께 제공되므로, 원본에서 목록을 수정할 수 있습니다. |
expires_at | 결과가 만료되는 시점입니다. |
Read the matched users
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시간 동안 보관되며, 귀하의 애플리케이션 전용입니다. 그 이후에는
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 | 해당 API 키로는 이 애플리케이션의 사용자를 조회할 수 없습니다. |
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.