跳转到主要内容
GET
curl
报告会根据交易的当前数据按需生成,因此在状态变更后需要再次调用,才能获取最新副本。与其他交易端点不同,它使用应用级路径:请在 URL 中填入您的组织 ID,以及 API 密钥所属应用的 ID。参见查找您的组织 ID。
PDF 报告属于媒体内容。限定范围的 API 密钥需要 media: read 和 transactions: read 两项权限。没有媒体访问权限的密钥即使能通过获取交易以 JSON 形式读取交易,也会收到 403。

授权

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。

路径参数

organization_id
string<uuid>
必填

组织 UUID。

application_id
string<uuid>
必填

应用 UUID。必须是该 API 密钥所属的应用:在任何其他应用上使用该密钥都会返回 403。

transaction_uuid
string<uuid>
必填

Didit 交易 UUID:由 POST /v3/transactions/ 和 GET /v3/transactions/ 返回的 uuid。不接受您自己的 txn_id。

响应

渲染生成的 PDF,直接以二进制 application/pdf 形式返回。

The response is of type file.

最后修改于 2026年11月7日