跳转到主要内容
GET
curl
工作流路由事件(WORKFLOW_BRANCH_EVALUATED、WORKFLOW_STATUS_NODE_REACHED)及其 details 在 检索会话 中有说明。该接口还可以通过 ?include=events 在其决策中返回用户验证(KYC)会话的时间线。

授权

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。

路径参数

sessionId
string<uuid>
必填

验证会话的 UUID(由 POST /v3/session/ 返回的 session_id)。支持用户验证(KYC)和企业验证(KYB)会话 ID:服务器会跨两种会话类型解析该 ID。必须是格式正确的 UUID;格式不正确的值无法匹配路由并返回 HTML 404。

示例:

"11111111-2222-3333-4444-555555555555"

查询参数

limit
integer
默认值:50

每页最大事件数。默认值为 50。小于 1 的值或非数值将回退至 50;超过 1,000,000 的值将返回 400。

必填范围: 1 <= x <= 1000000
示例:

50

offset
integer
默认值:0

返回第一条结果前跳过的结果数量。默认为 0;负数或非数字值将回退为 0,大于 1,000,000 的值将返回 400。建议优先使用 next 和 previous URL。

必填范围: 0 <= x <= 1000000
示例:

0

ordering
string

可选的排序覆盖设置。默认顺序为 -sent_at。传入结果字段名称(例如 sent_at、created_at、event_type、feature_step 或 step)进行升序排序,添加 - 前缀进行降序排序,多个字段之间用逗号分隔。未知字段将被忽略。

示例:

"sent_at"

响应

该会话的一页事件,最新的排在最前。

count
integer
必填

会话的事件总数。

next
string<uri> | null
必填

下一页的 URL,最后一页为 null。

previous
string<uri> | null
必填

上一页的 URL,第一页为 null。

results
object[]
必填
最后修改于 2026年11月7日