메인 콘텐츠로 건너뛰기
GET
curl
Didit의 오늘의 시간대별 인증 조회 API는 요청에서 지정한 시간대 기준 자정부터 오늘 사용자 인증 건수를 시간대별로 반환하며, 같은 요일 지난주의 같은 시간대 데이터를 함께 제공합니다. Business Console 홈의 볼륨 카드에 표시되는 데이터이기도 합니다. 이 수치는 인증 데이터에서 실시간으로 읽어오므로, 방금 생성된 인증도 이미 포함됩니다. 날짜 범위와 기타 대시보드 수치는 Get Application Analytics를 사용하세요.
전체 액세스 권한이 있는 API 키만 이 엔드포인트를 호출할 수 있습니다. 권한 수준과 관계없이 범위 제한 키는 403을 받으며, 다른 애플리케이션의 키도 마찬가지입니다. 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 를 참고하십시오.

경로 매개변수

organization_id
string<uuid>
필수

조직 UUID입니다.

application_id
string<uuid>
필수

애플리케이션 UUID입니다. API 키가 속한 애플리케이션이어야 합니다. 다른 애플리케이션에 사용된 키는 403을 받습니다.

쿼리 매개변수

tz
string
기본값:UTC

오늘이 시작되는 자정의 기준 IANA 표준 시간대(예: Europe/Madrid 또는 America/Mexico_City)입니다. UTC의 경우 생략합니다.

예시:

"Europe/Madrid"

응답

현지 시간별 오늘의 인증 건수, 비교 대상 날짜의 인증 건수 및 오늘의 결과입니다.

지난주 같은 요일 대비 현지 시간별 오늘의 인증 건수입니다.

time_zone
string
필수

해당 날짜 및 시간이 속한 IANA 표준 시간대입니다.

예시:

"Europe/Madrid"

date
string<date>
필수

해당 시간대 기준 오늘 날짜입니다.

예시:

"2026-10-30"

current_hour
integer
필수

현재 현지 시간(시)입니다.

필수 범위: 0 <= x <= 23
예시:

14

previous_date
string<date>
필수

비교 기준일: 1주 전 같은 요일입니다.

예시:

"2026-10-23"

hours
integer[]
필수

00:00부터 현지 시간 기준 시간대별 오늘 생성된 인증 건수입니다. 앞으로 남은 시간대는 0입니다.

Required array length: 24 elements
필수 범위: x >= 0
previous_hours
integer[]
필수

00:00부터 현지 시간 기준 시간대별 비교 일자에 생성된 인증 건수입니다.

Required array length: 24 elements
필수 범위: x >= 0
total
integer
필수

오늘 현재까지 생성된 인증 건수입니다.

필수 범위: x >= 0
예시:

165

previous_total_so_far
integer
필수

동일한 현지 시간까지 비교 일자에 생성된 인증 건수입니다.

필수 범위: x >= 0
예시:

151

outcomes
object
필수

오늘의 인증 중 현재 승인됨, 검토 중 대기 및 거부됨 상태인 건수입니다. 나머지는 아직 완료되지 않았습니다.

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