跳转到主要内容
POST
curl

授权

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。

请求体

application/json
vendor_data
string
必填

您为此 token 作用域所限定的终端用户的内部标识符。强制作为使用该 token 提交的每笔交易的主体身份。

示例:

"user-042"

ttl_seconds
integer
默认值:900

token 生命周期,以秒为单位。默认为 900(15 分钟);最大值为 86400(24 小时)。

必填范围: x <= 86400
max_uses
integer | null

使用此 token 允许的最大成功提交次数。省略或设为 null 表示在 TTL 内不限使用次数。

响应

已签发的 token。将 sdk_token 传递给您的应用;它在 expires_at 之前通过 X-Transaction-Token 请求头对面向设备的 /v1/transactions/ endpoint 进行身份验证。

sdk_token
string

要传递给 SDK 的作用域交易 token。

expires_at
string<date-time>

token 停止被接受的时间。

最后修改于 2026年11月7日