跳转到主要内容
POST
curl

KYC 和 KYB 支持

适用于 用户验证(KYC) 和 企业验证(KYB) 两类会话。Didit 会根据 session_id 同时查找这两类会话,并生成一个 JWT 分享 token,其中包括:
接收方合作伙伴导入该 token 时,Didit 会连同关联数据一起克隆对应类型的会话(KYC 或 KYB)。

要求

  • 会话必须处于已结束状态(APPROVED、DECLINED、IN_REVIEW)。
  • 您必须拥有 write:sessions 权限。
  • for_application_id 必须是有效的 Didit 应用(通常是合作伙伴的应用)。

示例

响应:

TTL 范围

相关内容

授权

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

要为其生成 token 的源验证会话的 UUID。

示例:

"11111111-2222-3333-4444-555555555555"

请求体

application/json
for_application_id
string<uuid>
必填

将兑换该 token 的 Didit 应用的 UUID。必须存在、未被删除,且不同于调用方应用。可在 Business Console 的 Settings → Application 下找到。

示例:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
默认值:3600

token 生命周期,以秒为单位。最小值为 60,最大值为 86400(24 小时)。默认为 3600(1 小时)。

必填范围: 60 <= x <= 86400
示例:

3600

响应

已铸造共享 token。

share_token
string

HS256 签名的 JWT。将其原样作为 share_token 传递给目标应用上的 POST /v3/session/import-shared/。

示例:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

回显该 token 绑定的目标应用 UUID。

示例:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

源会话是用户验证(KYC)还是企业验证(KYB)会话。

可用选项:
user,
business
最后修改于 2026年11月7日