下载审核链接材料

GET

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

下载指定审核链接下已上传的材料。接口直接返回一个 ZIP 压缩包（Content-Type: application/zip），而非 JSON。

Path 参数

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

Query 参数

参数	类型	必填	说明
material_type	string	是	需下载的材料类型，多个用英文逗号分隔，如 business_license,authorization_letter
password	string	否	ZIP 压缩包打开密码（如设置）

常用的材料类型取值：id_person_img、id_info_img、business_license、authorization_letter、authorization_form、verification_form、face_snapshot、other；法人代表认证还可能包含 legal_id_person_img、legal_id_info_img、legal_verification_form。仅会返回该审核链接下实际存在的材料。

响应说明

成功时响应体为 ZIP 二进制流，并带有 Content-Disposition: attachment 头。请求失败时仍返回标准 JSON 错误结构。

curl -G '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' \
  --data-urlencode 'material_type=business_license,authorization_letter' \
  -o materials.zip

const params = new URLSearchParams({ material_type: 'business_license,authorization_letter' })
const response = await fetch(`https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x/materials?${params}`, {
  method: 'GET',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  }
})
const blob = await response.blob()

req, _ := http.NewRequest("GET", "https://api.certcloud.cn/openapi/v3/audit-links/al_7Kd9Qm2x/materials?material_type=business_license,authorization_letter", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
out, _ := os.Create("materials.zip")
io.Copy(out, resp.Body)

import requests

response = requests.get(
    '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',
    },
    params={'material_type': 'business_license,authorization_letter'}
)
with open('materials.zip', 'wb') as f:
    f.write(response.content)

200成功（二进制 ZIP）

HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename=audit_link_<链接ID>_materials_<时间戳>.zip

<ZIP 二进制内容>