跳转到主要内容
GET
cURL

KYC 与 KYB 支持

同时适用于用户验证(KYC)和企业验证(KYB)会话。Didit 会自动匹配对应的 PDF 模板:
  • 用户验证(KYC)会话 → 报告包含身份证件验证、活体检测、人脸比对、AML 与地址证明(POA)部分。
  • 企业验证(KYB)会话 → 报告包含公司登记、关键人员(UBO 与高管)、证件、AML、问卷、电话、邮箱和 IP 分析部分(前提是这些功能属于工作流的一部分)。
两者使用相同的 PDF 生成流程,并支持白标定制(徽标、隐私政策 URL)。

文件名规则

通过 Content-Disposition: attachment; filename=... 响应头返回。

状态要求

会话必须处于 APPROVED、DECLINED 或 IN_REVIEW 状态才能生成 PDF。进行中或未开始的会话将返回 403。

示例

白标

当应用启用白标定制后,PDF 将使用您的徽标和隐私政策 URL。请在 控制台 → 定制 中进行配置。

权限

需要 read:sessions 权限。两种类型使用相同的权限范围。

相关内容

授权

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

要渲染的用户验证(KYC)或企业验证(KYB)会话的 UUID — 即 POST /v3/session/ 返回的 session_id。同一路径适用于两种会话类型;可通过响应中的 Content-Disposition 文件名区分您收到的报告类型。

必须是格式规范的小写 UUID。 该路由仅匹配有效 UUID,因此格式错误的值在任何应用代码运行之前就会被 URL 路由器拒绝,且响应为 404 HTML 页面,而不是如下所示的 JSON {"detail": ...} 信封。路由的 UUID 转换器仅匹配标准规范小写格式 — 大写十六进制 UUID 会被拒绝并返回 HTML 404。

示例:

"11111111-2222-3333-4444-555555555555"

响应

渲染生成的 PDF 文档,直接以二进制 application/pdf 形式返回,没有 JSON 包装,也没有下载 URL 重定向。正文以 %PDF 魔数开头(PDF 1.7)。可将其保存为 .pdf 文件或直接流式传输给您的调用方。

The response is of type file.

最后修改于 2026年11月7日