跳转到主要内容
POST
curl
为用户验证(KYC)或企业验证(KYB)会话准备一个 ZIP 文件,包含所有文件:证件正反面、自拍照、活体视频和上传的证件,保持原始质量。 ZIP 在后台准备。调用返回 202 和该导出记录。使用 获取文件导出 读取导出记录,直到 status 变为 READY,然后下载 download_url。
  • 当同一会话的导出仍在准备中时,调用会返回该导出,而不会启动新的导出。
  • ZIP 在准备就绪 24 小时后删除;删除会话时,ZIP 会立即删除。
  • 已删除的会话无法导出,调用返回 404。
  • 每次导出都会写入会话的审计日志。
  • 限定范围的 API 密钥需要 media: read 和 decisions: read 权限。

授权

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。已删除的会话返回 404。

示例:

"11111111-2222-3333-4444-555555555555"

响应

正在准备中的导出。

包含会话中所有原始画质文件的一个 ZIP 包。

export_id
string<uuid>
必填

导出的 ID。将其传递给 GET /v3/session/{sessionId}/files-export/{exportId}/。

session_id
string<uuid>
必填

文件所属的会话。

status
enum<string>
必填

ZIP 准备期间为 PENDING 和 PROCESSING,可供下载后为 READY,无法准备时为 FAILED(请发起新的导出请求),ZIP 被删除后为 EXPIRED。

可用选项:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
必填

ZIP 包中的文件。仅当 status 为 READY 时设置。

size_bytes
integer<int64> | null
必填

ZIP 文件的大小(字节)。仅在 status 为 READY 时设置。

download_url
string<uri> | null
必填

ZIP 文件的签名 URL,短期内有效。仅在 status 为 READY 时设置;如需新的 URL,请重新读取该导出。

expires_at
string<date-time> | null
必填

ZIP 文件的删除时间,为生成就绪后 24 小时。仅当 status 为 READY 时设置。

error
string | null
必填

当 status 为 FAILED 时,导出失败的原因。

created_at
string<date-time>
必填

请求导出的时间。

completed_at
string<date-time> | null
必填

ZIP 文件就绪或导出失败的时间。

最后修改于 2026年11月7日