资质管理

接口列表

1. 创建资质

1.1 接口说明

接口地址：https://smssh.253.com/sms/v2/qualification/add 通用接口说明详见 API 调用说明

1.2 请求参数

1.3 请求示例

复制成功⧉
{
  "productType": "notify",
  "enterpriseName": "上海创蓝文化传播有限公司",
  "unifiedSocialCreditCode": "91310115MA1K4C2XXX",
  "attentionLine": "张三",
  "attentionIdCard": "310101199001011234",
  "legalName": "李四",
  "phoneNum": "13800000001",
  "endType": "2",
  "shareType": "1",
  "identityType": "2",
  "agentAuthorizationLetterImg": "/9j/4AAQSkZJRgABAQ...",
  "businessLicenseImg": "/9j/4AAQSkZJRgABAQ...",
  "nationalEmblemIdentityImg": "/9j/4AAQSkZJRgABAQ...",
  "figureIdentityImg": "/9j/4AAQSkZJRgABAQ...",
  "legalNationalEmblemIdentityImg": "/9j/4AAQSkZJRgABAQ...",
  "legalFigureIdentityImg": "/9j/4AAQSkZJRgABAQ...",
  "identityOfficePhotoImg": "/9j/4AAQSkZJRgABAQ...",
  "contractOtherFile": [
    "/9j/4AAQSkZJRgABAQ..."
  ],
  "remark": "首次提交资质"
}

1.4 响应参数

响应示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "msg": "深度接口2.0资质新增成功",
  "data": {
    "endCustomerId": "123456"
  }
}

2. 资质列表

2.1 接口说明

接口地址：https://smssh.253.com/sms/v2/qualification/list 通用接口说明详见 API 调用说明

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

2.2 请求参数

2.3 请求示例

复制成功⧉
{
  "productType": "notify",
  "companyName": "上海创蓝云智信息科技股份有限公司",
  "endType": "1"
}

2.4 响应参数

data.list 参数

响应示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "data": {
    "list": [
      {
        "agentAuthorizationLetterUrl": "https://example.com/api/filecentre/preview?key=...",
        "attentionIdCard": "310101199001011234",
        "attentionLine": "张三",
        "auditOpinion": "资料完整",
        "auditStatus": "2",
        "businessLicenseUrl": "https://example.com/api/filecentre/preview?key=...",
        "contractOtherPreviewUrl": null,
        "endCustomerId": "123456",
        "endType": "1",
        "enterpriseName": "上海创蓝云智信息科技股份有限公司",
        "figureIdentityUrl": "https://example.com/api/filecentre/preview?key=...",
        "identityOfficePhotoUrl": null,
        "identityType": "2",
        "legalFigureIdentityUrl": "https://example.com/api/filecentre/preview?key=...",
        "legalName": "李四",
        "legalNationalEmblemIdentityUrl": "https://example.com/api/filecentre/preview?key=...",
        "nationalEmblemIdentityUrl": "https://example.com/api/filecentre/preview?key=...",
        "oneToManyFlag": "0",
        "phoneNum": "13800000001",
        "remark": "首次提交资质",
        "unifiedSocialCreditCode": "913101165727226313"
      }
    ],
    "total": 1
  },
  "msg": "资质分页查询成功",
  "requestId": "f47ac10b58cc4372a5670e02b2c3d479"
}

3. 编辑资质

3.1 接口说明

接口地址：https://smssh.253.com/sms/v2/qualification/update 通用接口说明详见 API 调用说明

3.2 请求参数

3.3 请求示例

复制成功⧉
{
  "productType": "market",
  "endCustomerId": "123456",
  "legalName": "王五",
  "phoneNum": "13800000002",
  "agentAuthorizationLetterImg": "/9j/4AAQSkZJRgABAQ...",
  "businessLicenseImg": "/9j/4AAQSkZJRgABAQ...",
  "remark": "更新法人信息"
}

3.4 响应参数

响应示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "msg": "深度接口2.0资质编辑成功",
  "data": null
}

4. 删除资质

4.1 接口说明

接口地址：https://smssh.253.com/sms/v2/qualification/delete 通用接口说明详见 API 调用说明

注意：有绑定签名的资质无法删除，需先解除签名绑定。

4.2 请求参数

4.3 请求示例

复制成功⧉
{
  "productType": "market",
  "endCustomerId": "123456"
}

4.4 响应参数

响应示例（JSON）：

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

5. 资质变更日志查询

5.1 接口说明

接口地址：https://smssh.253.com/sms/v2/qualification/change-log/list 通用接口说明详见 API 调用说明

5.2 请求参数

5.3 请求示例

复制成功⧉
{
  "productType": "notify",
  "endCustomerId": "1234",
  "pageNo": 1,
  "pageSize": 10
}

5.4 响应参数

data.list 参数

data.list.*Info 参数

快照为变更前后的完整资质信息：未变更或未上传的字段为空（null 或省略），已设置为空的字段返回空字符串。

响应示例（JSON）：

复制成功⧉
{
  "code": "000000",
  "data": {
    "list": [
      {
        "id": 630121,
        "oldInfo": {
          "attentionIdCard": "",
          "attentionLine": "",
          "phoneNum": ""
        },
        "newInfo": {
          "attentionIdCard": "",
          "attentionLine": "",
          "phoneNum": "",
          "nationalEmblemIdentityUrl": "CuVyke4r0xdg=="
        },
        "createTime": "2026-08-07 20:28:18",
        "applyUser": "13800000003",
        "auditOpinion": "",
        "changeType": "终端资质",
        "auditStatus": 1
      }
    ],
    "total": 1
  },
  "msg": "资质分页查询成功"
}