签名管理

接口列表

1. 创建签名

1.1 接口说明

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

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 格式，大小不超过 2 MB。	-
trademarkAuthImg	String	否	商标持有人出具的授权书：Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
institutionImg	String	否	组织机构代码截图：查询地址，截图示例，Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
additionalAttachmentsImg	List<String>	否	补充材料：Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB，最多 9 张。	-

1.3 请求示例


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

1.4 响应参数

参数名称	类型	描述
code	String	请求状态码：`000000` 表示成功。
msg	String	提示信息：Unicode 字符编码，需自行解码。
requestId	String	请求 ID
data	Object	返回数据
-signId	String	签名 ID
-existedSignId	String	已存在的签名所对应的签名 ID：签名已存在时返回。

响应示例（JSON）：


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

2. 签名列表

2.1 接口说明

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

注意：运营商审核状态不是最终状态，审核通过后仍可能被运营商要求整改并重新驳回，建议每半小时刷新一次。

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` 表示成功。
msg	String	提示信息：Unicode 字符编码，需自行解码。
requestId	String	请求 ID
data	Object	返回数据
-total	Integer	列表总数
-list	Object[]	签名列表：每个元素的字段见 data.list 参数。

data.list 参数

参数名称	类型	描述
签名信息
signId	String	签名 ID
signName	String	签名名称
signatureStatus	String	平台审核签名状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-历史签名。
isSystemSignature	String	是否为默认签名：`0`-普通签名；`1`-默认签名。
实名信息
endCustomerId	String	终端资质 ID
companyName	String	企业名称
companyLicenseNo	String	统一社会信用代码
legalName	String	法人姓名
identityName	String	经办人姓名
identityNo	String	经办人身份证号
phoneNum	String	经办人手机号
realNameStatus	String	实名修改状态：`0`-未修改实名状态；`1`-审核中；`2`-审核通过；`3`-审核驳回。
运营商审核状态
cmOperatorStatus	String	中国移动审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败。
ctOperatorStatus	String	中国电信审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败。
cuOperatorStatus	String	中国联通审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败。

响应示例（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 接口说明

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

注意：运营商审核状态不是最终状态，审核通过后仍可能被运营商要求整改并重新驳回，建议每半小时刷新一次。

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` 表示成功。
msg	String	提示信息：Unicode 字符编码，需自行解码。
requestId	String	请求 ID
data	Object	返回信息：字段见 data 参数。

data 参数

参数名称	类型	描述
签名信息
signId	String	签名 ID
signName	String	短信签名名称：Unicode 字符编码，需解码。
signatureStatus	String	平台审核签名状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-历史签名。
isSystemSignature	String	是否为默认签名：`0`-普通签名；`1`-默认签名。
auditReason	String	审核驳回原因：Unicode 字符编码，需解码，仅驳回时返回。
实名信息
endCustomerId	String	终端资质 ID
companyName	String	企业名称
companyLicenseNo	String	统一社会信用代码
legalName	String	法人姓名
identityName	String	经办人姓名
identityNo	String	经办人身份证号
phoneNum	String	经办人手机号
realNameStatus	String	实名修改状态：`0`-未修改实名状态；`1`-审核中；`2`-审核通过；`3`-审核驳回。
运营商审核状态
cmOperatorStatus	String	中国移动审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败。
ctOperatorStatus	String	中国电信审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败。
cuOperatorStatus	String	中国联通审核状态：`1`-未审核；`2`-审核通过；`3`-审核驳回；`-1`-查询失败。
运营商驳回原因
cmOperatorRejectReason	List	移动运营商审核驳回原因：每个元素的字段见 data.*OperatorRejectReason 参数。
ctOperatorRejectReason	List	电信运营商审核驳回原因：每个元素的字段见 data.*OperatorRejectReason 参数。
cuOperatorRejectReason	List	联通运营商审核驳回原因：每个元素的字段见 data.*OperatorRejectReason 参数。

data.*OperatorRejectReason 参数

参数名称	类型	描述
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 接口说明

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

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	否	关联资质用途：`3`-自用；`4`-他用；当 `type=3` 时必填。	-
remark	String	否	备注	-
应用场景材料
appImg	String	否	APP 备案截图：需包含应用名称与开发者信息，Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
appOpenScreenshotImg	String	否	APP/小程序首页截图：需展示签名使用场景，Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
商标材料
sbjScreenshotImg	String	否	国家商标局官网查询结果截图：截图示例，Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
trademarkImg	String	否	商标注册证扫描件：Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
trademarkAuthImg	String	否	商标持有人出具的授权书：Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
企业与授权材料
institutionImg	String	否	组织机构代码证扫描件：查询地址，Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
companyUniqueScreenshotImg	String	否	国家企业信用信息公示系统截图：需体现企业名称唯一性，Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB。	-
signAuthImg	String	否	签名授权书：Base64 编码，支持 PNG、JPG、JPEG 格式，大小不超过 2 MB；当 `signatureSceneType=4` 时必填。	-

4.3 请求示例


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

4.4 响应参数

参数名称	类型	描述
code	String	请求状态码：`000000` 表示成功。
msg	String	提示信息：Unicode 字符编码，需自行解码。
requestId	String	请求 ID

响应示例（JSON）：


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

5. 删除签名

5.1 接口说明

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

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` 表示成功。
msg	String	提示信息：Unicode 字符编码，需自行解码。
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 响应参数

data.list 参数

3. 签名详情

3.1 接口说明

3.2 请求参数

3.3 请求示例

3.4 响应参数

data 参数

data.*OperatorRejectReason 参数

4. 编辑签名终端资质

4.1 接口说明

4.2 请求参数

4.3 请求示例

4.4 响应参数

5. 删除签名

5.1 接口说明

5.2 请求参数

5.3 请求示例

5.4 响应参数