创建审核链接

POST

/openapi/v3/audit-links

创建一个审核链接（Audit Link），用于将组织信息、个人信息及审核材料的填写与验证流程托管给终端用户完成。创建后返回一个可访问的 access_url，可直接发送给终端用户。

终端用户通过该链接在线填写并提交信息，平台完成审核后可通过获取审核链接详情查询进度与结果。

幂等

当当前 API 账户下的 business_id、end_user_id、product_id 完全一致时，系统会复用同一审核链接记录，但会撤销旧访问令牌并签发新的 token 与 access_url。命中已有链接时，初始的预填数据、字段配置、页面配置和有效期不会被本次请求覆盖。

Body 参数 application/json

参数	类型	必填	说明
business_id	string	是	业务标识，接入方自定义的业务单号，用于幂等与回查
end_user_id	string	是	终端用户标识
product_id	string	是	产品 ID
validity_period	int	否	链接有效期（单位：分钟）。默认 60 分钟，最小 30 分钟，最大 7 天
prefill_data	object	否	预填充数据，终端用户打开链接时自动带入
∟ person_info	object	否	个人信息预填
∟∟ first_name	string	否	名称
∟∟ last_name	string	否	姓氏
∟∟ job_title	string	否	职位
∟∟ telephone	string	否	电话
∟∟ id_type	string	否	证件类型
∟∟ id_number	string	否	证件号码
∟∟ email	string	否	联系人邮箱
∟ organization	object	否	组织信息预填
∟∟ name	string	否	组织名称
∟∟ address_line1	string	否	组织地址
∟∟ address_line2	string	否	组织地址 2
∟∟ city	string	否	城市
∟∟ state	string	否	省份
∟∟ postal_code	string	否	邮编
∟∟ country	string	否	国家地区代码（如 CN）
∟∟ telephone	string	否	组织电话
∟∟ biz_email	string	否	企业邮箱
∟∟ uscc	string	否	统一社会信用代码
∟∟ legal_person	object	否	法人信息（仅法人代表认证使用）
∟∟∟ first_name	string	否	法人名称
∟∟∟ last_name	string	否	法人姓氏
∟∟∟ id_type	string	否	法人证件类型
∟∟∟ id_number	string	否	法人证件号码
field_config	object	否	字段配置
∟ immutable_paths	array[string]	否	不可修改字段路径列表（终端用户不可编辑，见下方说明）
ui_config	object	否	页面配置
∟ success_redirect_url	string	否	提交成功后的跳转地址
∟ end_redirect_url	string	否	流程结束后的跳转地址
∟ language	string	否	页面语言标识
∟ theme_color	string	否	主题色
∟ hide_header	boolean	否	是否隐藏页头
∟ privacy_agreement_url	string	否	隐私协议地址

immutable_paths 可选值

路径用于锁定终端用户不可修改的字段，格式为 section.field：

• 个人信息：person_info.first_name、person_info.last_name、person_info.job_title、person_info.telephone、person_info.id_type、person_info.id_number、person_info.email
• 组织信息：organization.name、organization.address_line1、organization.address_line2、organization.city、organization.state、organization.postal_code、organization.country、organization.telephone、organization.biz_email、organization.uscc
• 法人信息：organization.legal_person.first_name、organization.legal_person.last_name、organization.legal_person.id_type、organization.legal_person.id_number
• 材料：materials.id_person_img、materials.id_info_img、materials.business_license、materials.authorization_letter、materials.verification_form、materials.face_snapshot、materials.other

除 materials.* 外，锁定字段必须在同次请求的 prefill_data 中提供对应的非空值；否则请求会被拒绝。个人型审核链接不能传入 prefill_data.organization。

预填字段长度与格式

以下长度均按 Unicode 字符计。个人信息中，first_name、last_name、job_title 最长 128，telephone 最长 64，id_type 最长 8 且仅支持 1 或 2，id_number 最长 128，email 最长 254 且必须为合法邮箱。

组织信息中，name、address_line1、address_line2 最长 256，city、state 最长 128，postal_code 最长 32，country 必须为两位 ISO 国家或地区代码，telephone 最长 64，biz_email 最长 254 且必须为合法邮箱，uscc 最长 64。法人信息中，first_name、last_name 最长 128，id_type 最长 32，id_number 最长 128。

返回数据

参数	类型	说明
id	string	审核链接 ID
token	string	访问令牌
access_url	string	审核链接访问地址
expires_at	string	链接过期时间
is_existing	boolean	此前是否存在活动访问令牌；不表示返回的 access_url 可复用，接口始终返回新令牌

curl -X POST 'https://api.certcloud.cn/openapi/v3/audit-links' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "business_id": "biz-20260601-001",
    "end_user_id": "000000001",
    "product_id": "trustasia_ide_bipro",
    "validity_period": 1440,
    "prefill_data": {
      "organization": {
        "name": "亚数信息科技（上海）有限公司（测试）",
        "country": "CN"
      }
    },
    "field_config": {
      "immutable_paths": ["organization.name"]
    },
    "ui_config": {
      "language": "zh-CN",
      "hide_header": false
    }
  }'

const response = await fetch('https://api.certcloud.cn/openapi/v3/audit-links', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: JSON.stringify({
    business_id: 'biz-20260601-001',
    end_user_id: '000000001',
    product_id: 'trustasia_ide_bipro',
    validity_period: 1440,
    prefill_data: {
      organization: { name: '亚数信息科技（上海）有限公司（测试）', country: 'CN' }
    },
    field_config: { immutable_paths: ['organization.name'] },
    ui_config: { language: 'zh-CN', hide_header: false }
  })
})
const data = await response.json()

body := map[string]interface{}{
  "business_id":     "biz-20260601-001",
  "end_user_id":     "000000001",
  "product_id":      "trustasia_ide_bipro",
  "validity_period": 1440,
  "prefill_data": map[string]interface{}{
    "organization": map[string]string{"name": "亚数信息科技（上海）有限公司（测试）", "country": "CN"},
  },
  "field_config": map[string]interface{}{"immutable_paths": []string{"organization.name"}},
}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST", "https://api.certcloud.cn/openapi/v3/audit-links", bytes.NewBuffer(jsonBody))
req.Header.Set("Content-Type", "application/json")
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',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={
        'business_id': 'biz-20260601-001',
        'end_user_id': '000000001',
        'product_id': 'trustasia_ide_bipro',
        'validity_period': 1440,
        'prefill_data': {
            'organization': {'name': '亚数信息科技（上海）有限公司（测试）', 'country': 'CN'}
        },
        'field_config': {'immutable_paths': ['organization.name']},
        'ui_config': {'language': 'zh-CN', 'hide_header': False}
    }
)
data = response.json()

200成功

{
  "data": {
    "id": "al_7Kd9Qm2x",
    "token": "eyJhbGciOi...",
    "access_url": "https://certcloud.cn/audit-links/al_7Kd9Qm2x?token=eyJhbGciOi...",
    "expires_at": "2026-06-02 12:00:00",
    "is_existing": false
  },
  "code": "success"
}