上传审核链接材料

POST

/openapi/v3/audit-links/:id/materials

向指定审核链接上传审核所需材料，使用 multipart/form-data 提交。每个表单字段对应一种材料类型，同一类型可上传多个文件。

Path 参数

参数	类型	必填	说明
id	string	是	审核链接 ID

Body 参数 multipart/form-data

按材料类型使用对应的表单字段名上传文件。id_person_img、id_info_img、business_license、authorization_letter、verification_form、face_snapshot 和 other 可附带对应的 <字段名>_immutable 布尔值，标记该类材料终端用户不可替换；authorization_form 当前不支持锁定。

表单字段	类型	必填	说明
id_person_img	file	否	证件人像面
id_info_img	file	否	证件信息面
business_license	file	否	营业执照
authorization_letter	file	否	授权书
authorization_form	file	否	授权表
verification_form	file	否	核查表
face_snapshot	file	否	人脸快照
other	file	否	其他材料
<字段名>_immutable	boolean	否	对应材料是否锁定为不可修改。支持 id_person_img、id_info_img、business_license、authorization_letter、verification_form、face_snapshot、other，如 business_license_immutable=true

上传限制

• id_person_img、id_info_img：单个文件不超过 5MB
• business_license、authorization_letter、authorization_form、verification_form：单个文件不超过 10MB
• face_snapshot：单个文件不超过 5MB
• other：单个文件不超过 50MB
• 同一审核链接通过 API 累计上传的材料不得超过 15 个；本次上传会计入累计数量
• 至少需要上传一个材料文件，否则返回参数错误

返回数据

参数	类型	说明
uploaded_count	int	本次成功上传的材料数量
materials	array[object]	已上传材料列表
∟ material_type	string	材料类型
∟ file_name	string	文件名

curl -X POST 'https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x/materials' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -F 'business_license=@/path/to/license.pdf' \
  -F 'business_license_immutable=true' \
  -F 'authorization_letter=@/path/to/auth.pdf'

const form = new FormData();
form.append('business_license', fileInput.files[0]);
form.append('business_license_immutable', 'true');
form.append('authorization_letter', authInput.files[0]);

const response = await fetch('https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x/materials', {
  method: 'POST',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: form
})
const data = await response.json()

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("business_license", "license.pdf")
part.Write(fileBytes)
_ = writer.WriteField("business_license_immutable", "true")
writer.Close()
req, _ := http.NewRequest("POST", "https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x/materials", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.post(
    'https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x/materials',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    files={'business_license': open('/path/to/license.pdf', 'rb')},
    data={'business_license_immutable': 'true'}
)
data = response.json()

200成功

{
  "data": {
    "uploaded_count": 2,
    "materials": [
      { "material_type": "business_license", "file_name": "license.pdf" },
      { "material_type": "authorization_letter", "file_name": "auth.pdf" }
    ]
  },
  "code": "success"
}