메인 콘텐츠로 건너뛰기
GET
curl
Business Console에도 이벤트 목록 위에 같은 수치가 표시됩니다. 저가치 텔레메트리가 다른 이벤트를 통해 이미 주소가 확인된 경우에만 보강을 조회하는 이유는 이벤트 수집 가이드의 IP 보강을 참고하세요. 보강된 주소가 포함하는 필드는 IP 보강에서 확인할 수 있습니다.

인증

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 를 참고하십시오.

쿼리 매개변수

days
integer
기본값:30

기간(일 단위)입니다. 기본값은 30이며, 값은 1에서 365 사이로 제한되고, 정수가 아닌 값은 30으로 대체됩니다. 적용된 값은 period_days로 반환됩니다.

필수 범위: 1 <= x <= 365

응답

해당 기간의 카운터 및 비율입니다.

events_ingested
integer
필수

새 이벤트가 저장되었습니다. 멱등성 재전송은 계산되지 않습니다.

events_rejected
integer
필수

배치 요청(서버 및 디바이스 레인) 내에서 거부된 항목 수입니다. 거부된 단일 이벤트 요청은 포함되지 않습니다.

enrichment_lookups
integer
필수

캐시 또는 새로 확인하여 공인 IP 주소가 확인된 이벤트입니다.

enrichment_cache_hits
integer
필수

캐시에서 응답된 조회 수.

enrichment_provider_calls
integer
필수

주소를 새로 확인해야 했던 조회 수.

enrichment_skipped_low_value
integer
필수

주소가 아직 알려지지 않은 낮은 가치의 텔레메트리 이벤트입니다. 자체적으로 주소를 새로 확인하지 않습니다.

unique_ips_seen
integer
필수

새로운 주소 확인이 필요했던 주소입니다.

period_days
integer
필수

클램핑 후 적용된 days 값입니다.

cache_hit_rate
number | null
필수

enrichment_cache_hits / enrichment_lookups, 소수점 넷째 자리까지 반올림. 조회가 없었던 경우 null.

unique_ip_ratio
number | null
필수

unique_ips_seen / events_ingested 값으로 소수점 4자리까지 반올림됩니다. 수집된 이벤트가 없으면 Null입니다.

provider_calls_per_1k_events
number | null
필수

수집된 이벤트 1,000건당 신규 해결 건수이며, 소수점 둘째 자리에서 반올림됩니다. 수집된 이벤트가 없는 경우 null입니다.

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