资质管理

更新时间：2026/8/13 更新内容：

新增资质接口：

1. 接口地址从 V1 升级到 V2；
2. 合同字段精简：去除「合同首页 / 有效期页 / 尾页」，合并为「终端合同照片」（contract_other_file，最多 20 张，支持图片/PDF）；
3. 终端合同照片规则：自用（end_type=1）选填、他用（end_type=2）必填；
4. 经办人核验升级：二要素（姓名+身份证）→ 三要素（姓名+身份证+手机号）；
5. 审核状态逻辑：自用通过经办人三要素+法人核验后自动「通过」；他用提交人工审核，状态「待审核」；
6. 新增参数 remark（备注）。

资质列表接口（原"资质查询"）：

1. 接口名称由"资质查询"更名为"资质列表"；
2. 返回字段同步精简合同字段，新增「终端合同照片」（contract_other_preview_url）、「审核状态」（audit_status）、「审核意见」（audit_opinion）；
3. 新增提示：接口返回的文件 URL 有效期为 5 分钟，过期需重新调用获取。

编辑资质接口：

1. 接口地址从 V1 升级到 V2；
2. 合同字段同步精简为「终端合同照片」（contract_other_file）；
3. 明确编辑规则：驳回/通过状态可编辑，待审核不可编辑；可修改经办人信息、授权书、终端合同、备注，提交后重新审核。

新增"资质变更查询"接口：

1. 新增资质变更查询接口（/v1/qualification/change-log/list），支持按终端资质 ID 查询变更记录；
2. 返回变更时间、操作账号、变更类型、审核状态、审核意见，以及变更前（old_info）/变更后（new_info）的完整资质快照。

更新时间：2026/6/17 更新内容：更新"资质添加、资质查询"相关接口。

接入准备

1、请先联系商务开通"深度接口账号"才能使用本目录下所有接口。 2、请登录控制台拿到发送短信的"API账号"，增加资质根据API账号为导向的。 3、应用场景材料：准备经办人授权书。 4、实名信息：经办人身份证、营业执照。

接口列表

1. 新增资质

【⚠️重要更新】：

• 合同字段精简：去除「合同首页 / 有效期页 / 尾页」，合并为「终端合同照片」（最多 20 张，支持图片/PDF）
• 终端合同照片：自用选填、他用必填
• 经办人核验升级：二要素（姓名+身份证）→ 三要素（姓名+身份证+手机号）
• 审核状态：自用通过经办人三要素+法人核验后自动「通过」；他用提交人工审核，状态「待审核」

1.1 请求地址

• 请求方式：post
• Content-Type：application/x-www-form-urlencoded
• 请求地址：https://api.chuanglan.com/api/apis/v2/qualification/add

1.2 请求参数

1.3 请求示例

复制成功⧉
username=17321332052&timestamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456&enterprise_name=北京XX科技有限公司&unified_social_credit_code=91110000XXXXXXXXXX&attention_line=张三&attention_id_card=110101199001011234&phone_num=13800138000&end_type=2&identity_type=2

1.4 响应参数

返回数据示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "data": {
    "id": 341708
  },
  "msg": "深度接口新增终端资质成功",
  "status": "success"
}

2. 资质列表

【⚠️重要更新】：返回字段同步精简合同字段，新增「终端合同照片」「资质审核状态」「审核意见」

2.1 请求地址

• 请求方式：post
• Content-Type：application/x-www-form-urlencoded
• 请求地址：https://api.chuanglan.com/api/apis/v1/qualification/list

注意：接口返回的文件 URL 有效期为 5 分钟，过期后需重新调用接口获取。

2.2 请求参数

2.3 请求示例

复制成功⧉

username=17321332052&timestamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456&start=1&length=10&company_name=科技&end_type=2
 

2.4 响应参数

返回数据示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "msg": "深度接口终端资质分页查询成功",
  "data": {
    "total": 1,
    "list": [
      {
        "end_customer_id": 10086,
        "enterprise_name": "北京XX科技有限公司",
        "unified_social_credit_code": "91110000XXXXXXXXXX",
        "attention_line": "张三",
        "attention_id_card": "110101199001011234",
        "legal_name": "李四",
        "phone_num": "13800138000",
        "identity_type": "2",
        "end_type": "2",
        "one_to_many_flag": "0",
        "agent_authorization_letter_url": "https://xxx.xxx.com/xxx.jpg",
        "business_license_url": "https://xxx.xxx.com/xxx.jpg",
        "national_emblem_identity_url": "https://xxx.xxx.com/xxx.jpg",
        "figure_identity_url": "https://xxx.xxx.com/xxx.jpg",
        "legal_national_emblem_identity_url": "https://xxx.xxx.com/xxx.jpg",
        "legal_figure_identity_url": "https://xxx.xxx.com/xxx.jpg",
        "identity_office_photo_url": "https://xxx.xxx.com/xxx.jpg",
        "contract_head_page_url": "https://xxx.xxx.com/xxx.jpg",
        "contract_validity_page_url": "https://xxx.xxx.com/xxx.jpg",
        "contract_tail_page_url": "https://xxx.xxx.com/xxx.jpg",
        "remark": ""
      }
    ]
  }
}

3. 编辑资质

【⚠️重要更新】：

• 驳回/通过状态可编辑，待审核不可编辑
• 可改经办人信息、授权书、终端合同、备注，提交后重新审核

3.1 请求地址

• 请求方式：post
• Content-Type：application/x-www-form-urlencoded
• 请求地址：https://api.chuanglan.com/api/apis/v2/qualification/modify

3.2 请求参数

3.3 请求示例

复制成功⧉
username=17321332052&timestamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456&end_customer_id=10086&phone_num=13900139000&remark=变更经办人手机号

3.4 响应参数

返回数据示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "msg": "深度接口编辑终端资质成功",
  "status": "success"
}

4. 资质变更查询

【⚠️重要更新】：返回变更时间、操作账号、变更内容、变更审核状态、变更前/后内容

4.1 请求地址

• 请求方式：post
• Content-Type：application/x-www-form-urlencoded
• 请求地址：https://api.chuanglan.com/api/apis/v1/qualification/change-log/list

4.2 请求参数

4.3 请求示例

复制成功⧉
username=17321332052&timestamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456&end_customer_id=123456&start=1&length=10

4.4 响应参数

old_info / new_info 字段说明：

返回数据示例（JSON）

复制成功⧉
{
  "code": "000000",
  "status": "success",
  "msg": "成功",
  "data": {
    "total": 1,
    "list": [
      {
        "id": 8801,
        "old_info": {
          "enterprise_name": "测试企业有限公司",
          "legal_name": "李四"
        },
        "new_info": {
          "enterprise_name": "测试企业有限公司",
          "legal_name": "王五"
        },
        "create_time": "2026-08-05 14:30:21",
        "apply_user": "jiangbo",
        "audit_opinion": "审核通过",
        "change_type": "法人",
        "audit_status": "2"
      }
    ]
  }
}

5. 删除资质

5.1 请求地址

• 请求方式：post
• Content-Type：application/x-www-form-urlencoded
• 请求地址：https://api.chuanglan.com/api/apis/v1/qualification/del

5.2 请求参数

5.3 请求示例

复制成功⧉
username=17321332052&timestamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456

5.4 响应参数

返回数据示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "msg": "深度接口删除终端资质成功",
  "status": "success"
}