提交发行人代表文件
此端点允许提交与已登记发行人的代表关联的文件。
Request
ENDPOINT
/issuer_management/issuer/ISSUER-KEY/issuer_representative/ISSUER-REPRESENTATIVE-KEY/documentMÉTODO
POSTPath Params
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
ISSUER-KEY | string | 发行人的唯一键(UUID v4)。 | 36 |
ISSUER-REPRESENTATIVE-KEY | string | 发行人代表的唯一键(UUID v4)。 | 36 |
Request Body
Request Body
{
"document_base64": "dGVzdGVfZG9jdW1lbnRfYmFzZTY0",
"document_type": "cnh"
}
Request Body Params
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
document_base64 * | string | Base64 编码的文件内容。 | - |
document_type * | string | 提交文件的类型。 | document_type 枚举 |
document_type 枚举
| 枚举值 | 描述 |
|---|---|
cnh | 驾驶证 |
cnh_front | 驾驶证正面 |
cnh_back | 驾驶证背面 |
cnh_digital | 数字驾驶证 |
rg_front | 身份证正面 |
rg_back | 身份证背面 |
proof_of_address | 地址证明 |
letter_of_attorney | 授权书 |
passport | 护照 |
national_registry_of_foreigners | 外国人国家登记 |
注意
所有登记均需至少提供一份身份证件(cnh、rg、passport 或 national_registry_of_foreigners),且如果代表类型为 attorney(代理人),还需提供授权书(letter_of_attorney)。
Response
STATUS
201Response Body
- 场景 1:自动验证(OCR 成功)
- 场景 2:需要人工审核
{
"document_key": "123e4567-e89b-12d3-a456-426614174000",
"document_type": "cnh",
"ocr_key": "6654f284-f690-4324-8c39-dcf0225ec8cf"
}
含义:文件已由 OCR 自动处理和验证。
{
"document_key": "8bf591a8-c184-47db-afd2-a5196de14cc3",
"document_type": "cnh",
"ocr_key": null
}
含义:文件无法通过 OCR 自动验证,已转入人工审核队列。
注意
成功请求(提交成功)的响应有两种不同行为,取决于自动验证(OCR)的结果。
Response Body Params
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
document_key | string | 提交文件的唯一标识符(UUID v4)。 | 36 |
document_type | string | 提交文件的类型。 | document_type 枚举 |
ocr_key | string | 与提交文件关联的 OCR 键。 | 36 |