跳转到主要内容
PATCH
curl
字段键就是您在工作流中为证件配置的键。有关证件和字段的设置方法,请参阅 Document AI;有关结果在会话决策中的显示位置,请参阅 Document AI 报告。

授权

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:服务器会跨两种会话类型解析该 ID。必须是格式正确的 UUID;格式不正确的值无法匹配路由并返回 HTML 404。

示例:

"11111111-2222-3333-4444-555555555555"

documentUuid
string<uuid>
必填

Document AI 证件的 UUID(GET /v3/session/{sessionId}/decision/ 中的 document_ai_documents[].items[].uuid)。它必须属于路径中的会话。

示例:

"44444444-5555-6666-7777-888888888888"

请求体

application/json
extracted_data
object

字段键(您为该证件配置的键)及其更正后的值。必须是 JSON 对象;按键逐项合并到存储的数据中。请直接省略该字段,而不要发送 null,否则会返回 400。

示例:
status
enum<string>

证件的新审核状态。

可用选项:
Approved,
Declined,
In Review,
Not Finished
示例:

"Approved"

响应

证件已更新。返回合并后的证件。

uuid
string<uuid>
必填

证件标识符。

document_key
string
必填

此上传内容所对应的已配置证件。

original_filename
string | null
必填

上传证件时使用的文件名。

file_url
string | null
必填

已上传文件的存储路径。这不是下载链接:请从会话决策中读取预签名的 file_url 来下载文件。

status
enum<string>
必填

证件的审核状态。

可用选项:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
必填

合并后提取的所有字段,以字段键作为键名。

最后修改于 2026年11月7日