메인 콘텐츠로 건너뛰기
POST
Python
Didit의 Look Up Users API는 한 번의 호출로 최대 20,000개의 식별자 목록을 애플리케이션의 사용자와 매칭하고, 어떤 식별자가 일치하는 사용자가 없는지 알려 줍니다. 보유한 계정 목록을 처리해야 할 때, 예를 들어 지급 일괄 처리의 수취인, 파트너의 계정 또는 사기 조회 결과를 다룰 때 사용하세요. 각 계정의 인증 상태를 확인해야 하는 경우에 적합합니다.

작동 방식

  1. 목록을 조회합니다. 식별자와 함께 POST /v3/users/lookup/을 호출합니다. 이 호출은 읽기 전용이며, lookup_id, 건수, 일치하는 사용자가 없는 식별자를 응답으로 반환합니다.
  2. 사용자를 조회합니다. lookup_id를 lookup 파라미터로 전달하여 사용자 목록 조회를 호출합니다. 응답에는 일치한 사용자만 포함되며, 식별자를 제출한 순서대로 정렬됩니다.

일치 규칙

각 식별자는 애플리케이션 내에서 다음 순서로 일치 여부를 확인합니다.
  • 빈 항목은 제외되며, 중복 항목은 처음 나온 항목만 남기고 제거됩니다.
  • 한 요청에는 최대 100,000개의 항목을 보낼 수 있습니다. 빈 항목과 중복 항목을 제거한 후에도 1개에서 20,000개 사이의 식별자가 남아 있어야 합니다. 두 한도 중 하나라도 초과하면 400과 code: too_many_identifiers가 반환됩니다.
  • 조회는 귀하의 애플리케이션 내에서만 수행됩니다.

요청

응답

Read the matched users

  • 사용자는 요청한 목록의 식별자 순서대로 반환되며, 페이지네이션은 limit과 offset으로 처리됩니다. 하나의 이메일이 여러 사용자와 일치하면 가장 오래된 계정이 먼저 나열됩니다.
  • 결과는 24시간 동안 보관되며, 귀하의 애플리케이션 전용입니다. 그 이후에는 lookup이 404 상태 코드와 함께 code: lookup_not_found를 반환합니다. 이 경우 목록을 다시 제출하십시오.

조회 결과 다시 읽기

GET /v3/users/lookup/{lookup_id}/는 조회와 같은 본문을 반환하며, 여기에 identifiers가 추가로 포함됩니다. 이 목록은 제출한 목록에서 빈 값과 중복을 제거하고 순서대로 남긴 목록입니다. 조회가 만료되었거나, 존재하지 않거나, 다른 애플리케이션에 속한 경우 404와 함께 code: lookup_not_found를 응답합니다.

오류

권한

API 키에는 사용자에 대한 읽기 권한이 있어야 하며, 이 엔드포인트는 데이터를 절대 변경하지 않습니다. 이 권한이 없는 키나 해지된 키는 403을 받게 됩니다. 키 범위는 키별로 API 키에서 설정합니다. Console의 역할 및 권한은 사용자가 Console에서 할 수 있는 작업을 결정하며, API 트래픽에는 적용되지 않습니다. Console에서 목록 조회에는 사용자 읽기 권한만 있으면 됩니다.

관련 문서

인증

x-api-key
string
header
필수

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.

본문

application/json
identifiers
string[]
필수

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
예시:

응답

The lookup was read. Use lookup_id with List users.

lookup_id
string<uuid>
필수

Pass it as lookup to List users.

requested
integer
필수

Identifiers read, after blanks and duplicates were removed.

found
integer
필수

Identifiers that matched at least one user.

not_found
object[]
필수
expires_at
string<date-time>
필수

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

마지막 수정일 2026년 11월 20일