跳转到主要内容
GET
Python
返回签署人为某个字段应用的签名或姓名首字母,格式为 PNG。图片路径位于字段的 image_url 中,具体位于 signatures[].documents[].fields[] 下,因此无需自行构造路径。调用此接口需要 read:sessions 权限。
手绘签名是签署人绘制的图像,也是盖印到已签名 PDF 中的图像。键入签名是签署人经过验证的姓名,采用其所选的手写风格;已签名 PDF 会以相同风格的文本形式保存该签名。如需提供签名本身的证明,请使用已签署文档和证据。 如果字段不属于该签署人,或未应用签名或姓名首字母,则返回 404,并附带 signature_field_not_found。如果已存储的图像与其记录的 SHA-256 不再匹配,则返回 400,并附带 signature_document_changed。删除会话后,该路由返回 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>
必填

用户验证(KYC)或企业验证(KYB)会话。

示例:

"11111111-2222-3333-4444-555555555555"

nodeId
string
必填

电子签名步骤:signatures[] 中项目的 node_id。

示例:

"feature_signature"

fieldId
string<uuid>
必填

该签名人副本上的字段,如该字段的 image_url 中所示。

响应

图像。

The response is of type file.

最后修改于 2026年11月7日