跳转到主要内容
POST
创建监控 token
认证功能是新功能,在 Didit 开启此接口之前,它保持关闭状态:在此之前,接口会返回 503 monitoring_unavailable。
浏览器端和原生 SDK 从用户设备调用此接口,您的服务器无需调用。随该凭证发送的每个事件都会记录在用户的 vendor_data 中,无论设备声称了什么。

授权

Authorization
string
header
必填

来自 POST /token/ 的该人员访问 token:请求头带有 typ: at+jwt 的 ES256 JWT,有效期最多 5 分钟。并非您的 Didit API 密钥。

请求体

application/json

为空:访问 token 已指明该人员。

响应

针对该人员的设备凭证。

用于从用户设备向交易监控发送该人员活动事件的短期设备凭证。它不与会话绑定:在 expires_at 之前保持可用,即使退出登录后也是如此。

monitoring_token
string
必填

设备凭证。请作为机密信息妥善保管。

示例:

"mt_2f8c1d9e7b6a5f4e3d2c1b0a"

expires_at
string<date-time>
必填

签发后最多 15 分钟。

示例:

"2026-10-17T10:56:14Z"

allowed_event_categories
string[]
必填

其可能发送的事件类别。身份验证和安全事件始终来自 Didit,绝不来自设备。

示例:
max_uses
integer
必填
示例:

1000

bind_to_origin
string | null
必填

凭证适用的浏览器来源:请求的 Origin,若无则为 null。

示例:

"https://app.example.com"

vendor_data
string
必填

记录所有事件的人员,无论设备发送什么内容。

示例:

"user-42"

最后修改于 2026年11月7日