签名管理

接入准备

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

接口列表

1、创建签名

1.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/signature/create

1.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
signType	String	是	签名类型：`1`-企业名称；`3`-商标；`4`-其他（如政企）	`1`
signName	String	是	签名名称（2~18字符）	-
signatureSceneType	Integer	是	关联资质用途：`3`-自用；`4`-他人	`3`
endCustomerId	String	是	资质 ID	-
sbjScreenshotImg	String	否	国家商标局官网查询结果截图 - Base64 编码，PNG/JPG/JPEG，≤2MB - 截图示例	-
trademarkAuthImg	String	否	商标持有人出具的授权书 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
institutionImg	String	否	组织机构代码截图 - Base64 编码，PNG/JPG/JPEG，≤2MB - （查询地址） - 截图示例	-
additionalAttachmentsImg	List<String>	否	补充材料 - Base64 编码，PNG/JPG/JPEG，≤2MB - 最多 9 张	-

1.3 请求示例

{
  "productType": "notify",
  "signType": "1",
  "signName": "创蓝科技",
  "signatureSceneType": 3,
  "endCustomerId": "123456",
}

1.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，`000000` 代表成功	`000000`
msg	String	提示信息（Unicode，需自行解码）	签名新增成功
requestId	String	请求id	-
data	Object	返回数据	-
-signId	String	签名ID	341708
-existedSignId	String	已存在的签名所对应的签名ID（签名已存在时返回）	-

返回数据示例（JSON）：

{
  "code": "000000",
  "msg": "签名新增成功",
  "data": {
    "signId": "100001",
    "existedSignId": null
  }
}

2、签名列表

2.1 请求地址

请求方式：post

Content-Type：application/json

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

2.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
pageNo	Integer	否	页码，默认`1`	-
pageSize	Integer	否	每页条数，默认`10`	-
signName	String	否	签名名称（支持模糊查询）	-
signatureStatus	String	否	平台审核签名状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-历史签名	-

2.3 请求示例

{
  "productType": "notify",
  "pageNo": 1,
  "pageSize": 10,
  "signName": "创蓝",
  "signatureStatus": "2"
}

2.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口签名列表查询成功
requestId	String	请求id	-
data	Object	返回数据	-
-total	Integer	列表总数	10
-list	Object[]	签名列表	-
--signId	String	签名ID	-
--signName	String	签名名称	-
--signatureStatus	String	平台审核签名状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-历史签名	`2`
--isSystemSignature	String	是否为默认签名：`0`-普通签名；`1`-默认签名	`0`
--realNameStatus	String	实名修改状态：`0`-未修改实名状态；`1`-审核中；`2`-审核通过；`3`-审核驳回	`2`
--companyName	String	企业名称	-
--companyLicenseNo	String	统一社会信用代码	-
--legalName	String	法人	-
--identityNo	String	经办人身份证号	-
--identityName	String	经办人姓名	-
--phoneNum	String	经办人手机号	-
--endCustomerId	String	资质 ID	-
--cmOperatorStatus	String	中国移动审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败	`2`
--ctOperatorStatus	String	中国电信审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败	`2`
--cuOperatorStatus	String	中国联通审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败	`2`

返回数据示例（JSON）：

{
  "code": "000000",
  "msg": "深度接口2.0签名列表查询成功",
  "data": {
    "total": 5,
    "list": [
      {
        "signId": "100001",
        "signName": "创蓝科技",
        "signatureStatus": "2",
        "isSystemSignature": "0",
        "realNameStatus": "2",
        "companyName": "上海创蓝文化传播有限公司",
        "companyLicenseNo": "91310115MA1K4C2XXX",
        "legalName": "李四",
        "identityNo": "310101199001011234",
        "identityName": "张三",
        "phoneNum": "13800000001",
        "endCustomerId": "123456",
        "cmOperatorStatus": "1",
        "ctOperatorStatus": "1",
        "cuOperatorStatus": "1"
      }
    ]
  }
}

3、签名详情

3.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/signature/detail

3.2 请求参数

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

3.3 请求示例

{
  "productType": "market",
  "signId": "100001"
}

3.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口根据 id 查询签名成功
requestId	String	请求id	-
data	Object	返回信息	-
-signId	String	签名ID	-
-signName	String	短信签名名称（Unicode，需解码）	-
-signatureStatus	String	平台审核签名状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-历史签名	`2`
-isSystemSignature	String	是否为默认签名：`0`-普通签名；`1`-默认签名	`0`
-auditReason	String	审核驳回的原因（Unicode，需解码），仅驳回时有此参数	该签名行业属性不符合规定的发送要求
-realNameStatus	String	实名修改状态：`0`-未修改；`1`-审核中；`2`-审核通过；`3`-审核驳回	`2`
-companyName	String	企业名称	-
-companyLicenseNo	String	统一社会信用代码	-
-legalName	String	法人	-
-identityNo	String	经办人身份证号	-
-identityName	String	经办人姓名	-
-phoneNum	String	经办人手机号	-
-endCustomerId	String	资质 ID	-
-cmOperatorStatus	String	中国移动审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败	`2`
-ctOperatorStatus	String	中国电信审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败	`2`
-cuOperatorStatus	String	中国联通审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败	`2`
-cmOperatorRejectReason	List	移动运营商审核驳回原因	-
--issueType	Integer	问题类型：`1`-签名问题；`2`-签名材料问题；`3`-终端资质问题；`4`-其他；`5`-引流问题	-
--issueDesc	String	问题描述	-
--operationRecommend	String	操作建议	-
--modifyModules	String	修改模块：`1`-新增终端资质；`2`-变更签名终端资质；`3`-修改签名材料；`4`-变更签名类型；`5`-新增签名；`6`-修改链接材料；`7`-修改联系方式材料；`8`-无需修改	-
-ctOperatorRejectReason	List	电信运营商审核驳回原因	-
--issueType	Integer	问题类型：`1`-签名问题；`2`-签名材料问题；`3`-终端资质问题；`4`-其他；`5`-引流问题	-
--issueDesc	String	问题描述	-
--operationRecommend	String	操作建议	-
--modifyModules	String	修改模块：`1`-新增终端资质；`2`-变更签名终端资质；`3`-修改签名材料；`4`-变更签名类型；`5`-新增签名；`6`-修改链接材料；`7`-修改联系方式材料；`8`-无需修改	-
-cuOperatorRejectReason	List	联通运营商审核驳回原因	-
--issueType	Integer	问题类型：`1`-签名问题；`2`-签名材料问题；`3`-终端资质问题；`4`-其他；`5`-引流问题	-
--issueDesc	String	问题描述	-
--operationRecommend	String	操作建议	-
--modifyModules	String	修改模块：`1`-新增终端资质；`2`-变更签名终端资质；`3`-修改签名材料；`4`-变更签名类型；`5`-新增签名；`6`-修改链接材料；`7`-修改联系方式材料；`8`-无需修改	-

返回数据示例（JSON）：

{
  "code": "000000",
  "msg": "深度接口2.0签名详情查询成功",
  "data": {
    "signId": "100001",
    "signName": "创蓝科技",
    "signatureStatus": "2",
    "isSystemSignature": "0",
    "auditReason": null,
    "realNameStatus": "2",
    "companyName": "上海创蓝文化传播有限公司",
    "companyLicenseNo": "91310115MA1K4C2XXX",
    "legalName": "李四",
    "identityNo": "420***********0818",
    "identityName": "张三",
    "phoneNum": "13800000001",
    "endCustomerId": "123456",
    "cmOperatorStatus": "1",
    "ctOperatorStatus": "3",
    "cuOperatorStatus": "1",
    "cmOperatorRejectReason": null,
    "ctOperatorRejectReason": [
      {
        "issueDesc": "签名类型",
        "issueType": 4,
        "modifyModules": "8",
        "operationRecommend": "变更签名类型"
      },
      {
        "issueDesc": "请联系人工客服处理",
        "issueType": null,
        "modifyModules": null,
        "operationRecommend": null
      }
    ],
    "cuOperatorRejectReason": null
  }
}

4、编辑签名终端资质

4.1 请求地址

请求方式：post

Content-Type：application/json

请求地址：https://smssh.253.com/sms/v2/signature/real-name-update

4.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
signId	String	是	签名ID	-
endCustomerId	String	是	资质 ID	-
type	String	是	修改类型：`2`-修改实名资质；`3`-修改应用场景	`2`
signatureSceneType	Integer	否	关联资质用途（type=3时必填）：`3`-自用；`4`-他人	-
appImg	String	否	APP备案截图（需含应用名称与开发者信息） - Base64 编码，PNG/JPG/JPEG，≤2MB	-
appOpenScreenshotImg	String	否	APP/小程序首页截图（需展示签名使用场景） - Base64 编码，PNG/JPG/JPEG，≤2MB	-
sbjScreenshotImg	String	否	国家商标局官网查询结果截图 - Base64 编码，PNG/JPG/JPEG，≤2MB - （截图示例）	-
trademarkImg	String	否	商标注册证扫描件 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
trademarkAuthImg	String	否	商标持有人出具的授权书 - Base64 编码，PNG/JPG/JPEG，≤2MB	-
institutionImg	String	否	组织机构代码证扫描件 - Base64 编码，PNG/JPG/JPEG，≤2MB - （查询地址）	-
companyUniqueScreenshotImg	String	否	国家企业信用信息公示系统截图（需体现企业名称唯一性） - Base64 编码，PNG/JPG/JPEG，≤2MB	-
signAuthImg	String	否	签名授权书 - Base64 编码，PNG/JPG/JPEG，≤2MB - 当 `signatureSceneType=4` 时必填	-
remark	String	否	备注	-

4.3 请求示例

{
  "productType": "notify",
  "signId": "100001",
  "endCustomerId": "123456",
  "type": "3",
  "signatureSceneType": 4,
  "signAuthImg": "/9j/4AAQ...",
  "remark": "修改为他人场景"
}

4.4 响应参数

名称	类型	说明	示例值
code	String	请求状态码，000000 代表成功	000000
msg	String	提示信息（Unicode，需自行解码）	深度接口2.0实名信息修改成功
requestId	String	请求id	-

返回数据示例（JSON）：

{
  "code": "000000",
  "msg": "深度接口2.0实名信息修改成功"
}

5、删除签名

5.1 请求地址

请求方式：post

Content-Type：application/json

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

5.2 请求参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`notify`
signId	String	是	签名ID，创建签名时返回的签名ID	-

5.3 请求示例

{
  "productType": "notify",
  "signId": "341708"
}

5.4 响应参数

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

返回数据示例（JSON）：

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

产品中心

热门搜索

中国站

国际站

接入准备

接口列表

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