메인 콘텐츠로 건너뛰기
GET
curl

개요

인증된 애플리케이션의 사용자 엔터티 목록을 페이지 단위로 반환합니다. 사용자를 웨어하우스에 동기화하거나, 분석가의 확인이 필요한 사용자를 찾거나, 표시 이름으로 검색할 때 사용하세요.

사용 시기

  • 정기 동기화: 사용자 테이블을 외부 BI 또는 웨어하우스에 동기화합니다.
  • 분석가 대기열: status=FLAGGED 또는 오래된 last_activity_at으로 필터링해 검토용 수신함으로 활용하세요.
  • 사용자 검색: display_name, full_name, vendor_data로 사용자를 검색합니다.

필터 및 페이지네이션

참고 사항

  • 각 응답 항목에는 didit_internal_id가 포함됩니다. 원본 세션 또는 거래가 값을 제공하지 않은 경우 vendor_data는 null일 수 있습니다.
  • 이 엔드포인트는 커서 기반으로 페이지네이션됩니다. 호출 사이에 next 커서를 저장하고, next가 비어 있으면 호출을 중단하세요.
  • 사용자 행의 모든 필드는 사용자 데이터 모델에서 확인하세요.

권한

애플리케이션의 활성 API 키는 모두 이 엔드포인트를 호출할 수 있습니다. Didit API 키는 역할이 아닌 애플리케이션 범위로 적용됩니다. 콘솔의 역할 및 권한(list:users 등)은 사람이 콘솔에서 할 수 있는 작업을 결정하며, Management API 트래픽에는 평가되지 않습니다. 이 엔드포인트를 호출할 수 있는 대상은 애플리케이션의 API 키를 읽을 수 있는 사람으로 통제하세요.

관련 문서

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

쿼리 매개변수

limit
integer
기본값:50

페이지 크기입니다. 생략 시 기본값은 50입니다. 강제된 최댓값은 없으나 지연 시간을 줄이려면 페이지를 작게 유지하십시오.

필수 범위: 1 <= x <= 1000000
offset
integer
기본값:0

반환할 첫 번째 레코드의 0부터 시작하는 오프셋입니다. 직접 계산하기보다는 이전 페이지의 next URL을 따르는 것이 좋습니다.

필수 범위: 0 <= x <= 1000000

응답

인증 상태, 세션 수 및 기능 분석 정보가 포함된 페이지 단위로 제공되는 사용자 목록입니다.

count
integer

일치하는 행 수입니다. 최대 100개까지 정확하며, 성능을 위해 그 이상은 100개로 제한됩니다. 마지막 페이지를 감지하는 데 사용하지 마십시오. 대신 next가 null인지 확인하십시오.

next
string | null

다음 페이지의 절대 URL이며, 마지막 페이지에서는 null입니다.

previous
string | null

이전 페이지의 절대 URL이며, 첫 번째 페이지에서는 null입니다.

results
object[]
마지막 수정일 2026년 11월 7일