跳转到主要内容
GET
curl
Business Console 在事件列表上方显示相同的数字。有关低价值遥测数据为何仅在另一事件已解析该地址时才读取富化结果,请参阅事件接入指南中的 IP 富化;有关已富化地址所包含字段的说明,请参阅 IP 富化。

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 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,四舍五入保留 4 位小数。没有查询时为 Null。

unique_ip_ratio
number | null
必填

unique_ips_seen / events_ingested,保留 4 位小数。未摄取任何事件时为 null。

provider_calls_per_1k_events
number | null
必填

每 1000 个摄入事件的新增解析数,四舍五入保留 2 位小数。未摄入事件时为 null。

最后修改于 2026年11月7日