跳转到主要内容
GET
curl
Didit 的按小时获取今日验证数 API 会返回今日每个小时的用户验证数,起点为您所传时区的当地午夜,并与上周同一星期几的相同时段并排显示。它是 Business Console 首页数量卡片背后的数据。 这些数据是实时从您的验证记录中读取的,因此刚刚创建的验证已经计入其中。如需查看日期范围及其他仪表板数据,请使用 获取应用分析。
只有具有完整访问权限的 API 密钥才能调用此 endpoint。受限权限的密钥无论拥有何种访问权限,都会收到 403,其他应用的密钥同样如此。详见 API 密钥。

相关内容

授权

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。

路径参数

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>
必填

对比基准日:一周前的同一个工作日/周几。

示例:

"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日