资质管理

接入准备

通用请求说明详见 API调用说明

接口列表

1、创建资质

1.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/qualification/add

1.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
enterpriseName	String	是	企业名称	-
unifiedSocialCreditCode	String	是	统一社会信用代码	-
legalName	String	是	法人姓名	-
attentionLine	String	是	经办人姓名	-
attentionIdCard	String	是	经办人身份证号	-
phoneNum	String	是	经办人手机号	-
identityType	String	否	经办人类型：`1`-法人；`2`-经办人（默认值）	`2`
endType	String	否	签名实名使用方：`1`-自用；`2`-他用（默认值）	`1`
shareType	String	是	共享范围：`0`-此账号；`1`-所有主子账号	`0`
businessLicenseImg	String	是	营业执照图片 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
legalNationalEmblemIdentityImg	String	是	法人身份证国徽面 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
legalFigureIdentityImg	String	是	法人身份证人像面 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
agentAuthorizationLetterImg	String	条件必填	经办人授权书图片 - Base64 编码，PNG/JPG/JPEG，≤2MB - 当 `identityType=2` 时必填	-
nationalEmblemIdentityImg	String	条件必填	经办人身份证国徽面 - Base64 编码，PNG/JPG/JPEG，≤2MB - 当 `identityType=2` 时必填	-
figureIdentityImg	String	条件必填	经办人身份证人像面 - Base64 编码，PNG/JPG/JPEG，≤2MB - 当 `identityType=2` 时必填	-
identityOfficePhotoImg	String	否	经办人办公场景照片 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
contractOtherFile	List<String>	条件必填	终端合同照片 - Base64 编码，数量≤20个 - PDF≤5MB / 图片≤2MB - 当 `endType=2` 时必填	-
remark	String	否	备注	-

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 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口2.0资质新增成功
requestId	String	请求id	-
data	Object	返回数据	-
-endCustomerId	String	终端资质ID	123456

返回数据示例（JSON）：

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

2、资质列表

2.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/qualification/list

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

2.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
companyName	String	是	企业名称，支持模糊搜索	-
endType	String	否	终端类型：`1`-自用；`2`-他用	-
pageNo	Integer	否	页码，默认`1`	-
pageSize	Integer	否	每页条数，默认`10`	-

2.3 请求示例

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

2.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口2.0资质分页查询成功
requestId	String	请求id	-
data	Object	返回数据	-
-total	Integer	总数	-
-list	Object[]	资质列表	-
--endCustomerId	String	终端资质ID	-
--enterpriseName	String	企业名称	-
--unifiedSocialCreditCode	String	统一社会信用代码	-
--attentionLine	String	经办人姓名	-
--attentionIdCard	String	经办人身份证号	-
--legalName	String	法人姓名	-
--phoneNum	String	经办人手机号	-
--identityType	String	经办人类型：`1`-法人；`2`-经办人	`2`
--endType	String	终端类型：`1`-自用；`2`-他用	`2`
--oneToManyFlag	String	一人多企：`0`-否；`1`-是	0
--agentAuthorizationLetterUrl	String	经办人授权书URL	-
--businessLicenseUrl	String	营业执照URL	-
--nationalEmblemIdentityUrl	String	经办人身份证国徽面URL	-
--figureIdentityUrl	String	经办人身份证人像面URL	-
--legalNationalEmblemIdentityUrl	String	法人身份证国徽面URL	-
--legalFigureIdentityUrl	String	法人身份证人像面URL	-
--identityOfficePhotoUrl	String	经办人办公场景URL	-
--contractOtherPreviewUrl	List<String>	终端合同照片(Base64)	-
--contractHeadPageUrl	String	（已废弃）合同首页URL	-
--contractValidityPageUrl	String	（已废弃）合同有效期页URL	-
--contractTailPageUrl	String	（已废弃）合同尾页URL	-
--remark	String	备注	-

返回数据示例（JSON）：

{
  "code": "000000",
  "data": {
    "list": [
      {
        "endCustomerId": "123456",
        "endType": "2",
        "figureIdentityUrl": "http://172.16.42.128:8080/apis/filecentre/preview?key=...",
        "remark": "",
        "businessLicenseUrl": "http://172.16.42.128:8080/apis/filecentre/preview?key=...",
        "attentionLine": "彭宪忠",
        "attentionIdCard": "445381199266666038",
        "oneToManyFlag": "0",
        "unifiedSocialCreditCode": "914400000003HPY11X",
        "phoneNum": "13090009119",
        "legalName": "舒琴",
        "identityType": "2",
        "enterpriseName": "深圳市浪花旅游有限公司",
        "agentAuthorizationLetterUrl": "http://172.16.42.128:8080/apis/filecentre/preview?key=..."
      }
    ],
    "total": 1
  },
  "msg": "资质分页查询成功"
}

3、编辑资质

3.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/qualification/update

3.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
endCustomerId	String	是	终端资质ID	-
identityType	String	否	经办人类型：`1`-法人；`2`-经办人	`1`
legalName	String	否	法人姓名	-
phoneNum	String	否	经办人手机号	-
agentAuthorizationLetterImg	String	否	经办人授权书 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
businessLicenseImg	String	否	营业执照 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
nationalEmblemIdentityImg	String	否	经办人身份证国徽面 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
figureIdentityImg	String	否	经办人身份证人像面 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
legalNationalEmblemIdentityImg	String	否	法人身份证国徽面 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
legalFigureIdentityImg	String	否	法人身份证人像面 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
identityOfficePhotoImg	String	否	经办人办公场景 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
contractOtherFile	List<String>	否	终端合同照片 - Base64 编码，数量≤20个 - PDF≤5MB / 图片≤2MB	-
remark	String	否	备注	-

3.3 请求示例

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

3.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口2.0资质编辑成功
requestId	String	请求id	-
data	Object	返回数据	-

返回数据示例（JSON）：

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

4、删除资质

4.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/qualification/delete

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

4.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
endCustomerId	String	是	终端资质ID	-

4.3 请求示例

{
  "productType": "market",
  "endCustomerId": "123456"
}

4.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口2.0资质删除成功
requestId	String	请求id	-
data	Object	返回数据	-

返回数据示例（JSON）：

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

5、资质变更日志查询

5.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/qualification/change-log/list

5.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
endCustomerId	String	是	终端资质ID	-
pageNo	Integer	否	页码，默认`1`	-
pageSize	Integer	否	每页条数，默认`10`，最大 100	-

5.3 请求示例

{
  "productType": "notify",
  "endCustomerId": "1234",
  "pageNo": 1,
  "pageSize": 10
}

5.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	资质分页查询成功
requestId	String	请求id	-
data	Object	返回数据	-
-total	Integer	总记录数	1
-list	Object[]	变更记录列表	-
--id	Integer	变更记录ID	630121
--oldInfo	Object	变更前资质快照	-
--newInfo	Object	变更后资质快照	-
--createTime	String	提交时间	2026-08-07 20:28:18
--applyUser	String	申请人	17601322176
--auditOpinion	String	审核意见	-
--changeType	String	变更类型	终端资质
--auditStatus	Integer	审核状态：`1`-待审；`2`-过审；`3`-驳回	1

返回数据示例（JSON）：

{
  "code": "000000",
  "data": {
    "list": [
      {
        "id": 630121,
        "oldInfo": {
          "legalCertNo": "",
          "identityNo": "",
          "phoneNum": ""
        },
        "newInfo": {
          "legalCertNo": "",
          "identityNo": "",
          "phoneNum": "",
          "identityOfficePhotoPreviewUrl": "CuVyke4r0xdg=="
        },
        "createTime": "2026-08-07 20:28:18",
        "applyUser": "17601322176",
        "auditOpinion": "",
        "changeType": "终端资质",
        "auditStatus": 1
      }
    ],
    "total": 1
  },
  "msg": "资质分页查询成功"
}

产品中心

热门搜索

中国站

国际站

接入准备

接口列表

1、创建资质

1.1 请求地址

1.2 请求参数

1.3 请求示例

1.4 响应参数

2、资质列表

2.1 请求地址

2.2 请求参数

2.3 请求示例

2.4 响应参数

3、编辑资质

3.1 请求地址

3.2 请求参数

3.3 请求示例

3.4 响应参数

4、删除资质

4.1 请求地址

4.2 请求参数

4.3 请求示例

4.4 响应参数

5、资质变更日志查询

5.1 请求地址

5.2 请求参数

5.3 请求示例

5.4 响应参数