跳转到主要内容
GET
curl
读取通过导出文件发起的导出任务。
  • PENDING 和 PROCESSING:ZIP 正在准备中。请在几秒后再次读取该导出任务。
  • READY:download_url 是指向 ZIP 文件的签名链接,在短时间内有效。请在 expires_at 之前再次读取该导出任务,以获取新的链接。
  • FAILED:ZIP 无法准备完成。请发起新的导出。
  • EXPIRED:ZIP 已被删除。请发起新的导出。
每次返回下载链接的读取操作都会记录到该会话的审计日志中。对已删除会话的导出请求将返回 404。

授权

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"

exportId
string<uuid>
必填

POST /v3/session/{sessionId}/files-export/ 返回的 export_id。

示例:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

响应

导出。

包含会话中所有原始画质文件的一个 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日