签名管理
更新时间:2026-07-30 11:27:39
说明
参数列表的可选属性 M:表示必选。 O:表示任意可选。 C:表示条件可选。
一、创建签名
说明
创建签名接口。
方法
- 请求方法: POST
- Content-Type:application/json; charset=utf-8
- 请求网址:https://rcs.253.com/rcs/api/sign/add_sign
参数
Body:
| 字段 | 数据类型 | 可选属性 | 描述 |
|---|---|---|---|
| appId | string | M | 发送账号 |
| sign | string | M | 签名名称 |
| customerCode | string | M | 所属客户编码,请查枚举例子 |
| industryCode | string | M | 行业属性编码,请查枚举例子 |
| signType | string | M | 签名类型 0:非游戏类1:游戏类 |
| timestamp | string | M | 时间戳。格式:System.currentTimeMillis() / 1000 |
| signature | string | M | 验签签名,参与字段由appId、sign、customerCode、industryCode、signType、timestamp组成 |
| body | SignMaterialBody | M | 素材body |
| businessName | string | C | 企业名称 |
| creditCode | string | C | 统一社会信用代码 |
| handledbyName | string | C | 经办人 |
| relevantIdcard | string | C | 经办人身份证号 |
SignMaterialBody:
| 字段 | 数据类型 | 可选属性 | 描述 |
|---|---|---|---|
| authorizeFile | List< MaterialParam> | M | 授权文件。限制3个, |
| entrustFile | MaterialParam | M | 委托书文件。限制1个 |
| jobPermitFile | MaterialParam | M | 营业执照文件。限制1个 |
| editionFile | List< MaterialParam> | C | 网终游戏出版物号。限制10个。当签名为游戏类时必传。 |
| softnessFile | List< MaterialParam> | C | 软件著作权登记证书。限制10个。当签名为游戏类时必传。 |
MaterialParam:
| 字段 | 数据类型 | 可选属性 | 描述 |
|---|---|---|---|
| source | string | M | 素材来源,1:base64(默认) 2:url |
| type | string | M | 素材格式 eg:png |
| content | string | M | 素材具体内容:具体的base64 或 具体的url |
返回值
| 字段 | 数据类型 | 描述 |
|---|---|---|
| code | string | 返回码 |
| message | string | 错误描述 |
| data | object | |
| --> signId | string | 签名id |
示例
customerCode 所对应的 customerName
[
{
"customerCode": "1",
"customerName": "党政军"
},
{
"customerCode": "2",
"customerName": "民生"
},
{
"customerCode": "3",
"customerName": "医疗器械、药店"
},
{
"customerCode": "4",
"customerName": "电商"
},
{
"customerCode": "5",
"customerName": "沿街商铺(中小)"
},
{
"customerCode": "6",
"customerName": "教育培训"
},
{
"customerCode": "7",
"customerName": "房地产"
},
{
"customerCode": "8",
"customerName": "游戏"
},
{
"customerCode": "9",
"customerName": "金融"
},
{
"customerCode": "10",
"customerName": "物流"
},
{
"customerCode": "11",
"customerName": "微商(个 人)"
},
{
"customerCode": "12",
"customerName": "企业(大型)"
},
{
"customerCode": "13",
"customerName": "其他"
}
]industryCode 所对应的 industryName
[
{
"industryName": "农业",
"industryCode": "01"
},
{
"industryName": "林业",
"industryCode": "02"
},
{
"industryName": "畜牧业",
"industryCode": "03"
},
{
"industryName": "渔业",
"industryCode": "04"
},
{
"industryName": "农、林、牧、渔专业及辅助性活动",
"industryCode": "70"
},
{
"industryName": "其他采矿业",
"industryCode": "05"
},
{
"industryName": "煤炭",
"industryCode": "06"
},
{
"industryName": "石油",
"industryCode": "07"
},
{
"industryName": "黑色金属矿采选业",
"industryCode": "71"
},
{
"industryName": "有色金属矿采选业",
"industryCode": "72"
},
{
"industryName": "非金属矿采选业",
"industryCode": "73"
},
{
"industryName": "开采专业及辅助性活动",
"industryCode": "74"
},
{
"industryName": "其他制造业",
"industryCode": "08"
},
{
"industryName": "农副食品加工业",
"industryCode": "75"
},
{
"industryName": "酒、饮料和精制茶制造业",
"industryCode": "76"
},
{
"industryName": "纺织业",
"industryCode": "77"
},
{
"industryName": "纺织服装、服饰业",
"industryCode": "78"
},
{
"industryName": "皮革、毛皮、羽毛及其制品和制鞋业",
"industryCode": "79"
},
{
"industryName": "木材加工和木、竹、藤、棕、草制品业",
"industryCode": "80"
},
{
"industryName": "家具制造业",
"industryCode": "81"
},
{
"industryName": "造纸和纸制品业",
"industryCode": "82"
},
{
"industryName": "印刷和记录媒介复制业",
"industryCode": "83"
},
{
"industryName": "文教、工美、体育和娱乐用品制造业",
"industryCode": "84"
},
{
"industryName": "石油、煤炭及其他燃料加工业",
"industryCode": "85"
},
{
"industryName": "化学纤维制造业",
"industryCode": "86"
},
{
"industryName": "橡胶和塑料制品业",
"industryCode": "87"
},
{
"industryName": "非金属矿物制品业",
"industryCode": "88"
},
{
"industryName": "黑色金属冶炼和压延加工业",
"industryCode": "89"
},
{
"industryName": "有色金属冶炼和压延加工业",
"industryCode": "90"
},
{
"industryName": "金属制品业",
"industryCode": "91"
},
{
"industryName": "通用设备制造业",
"industryCode": "92"
},
{
"industryName": "专用设备制造业",
"industryCode": "93"
},
{
"industryName": "铁路、船舶、航空航天和其他运输设备制造业",
"industryCode": "94"
},
{
"industryName": "电气机械和器材制造业",
"industryCode": "95"
},
{
"industryName": "计算机、通信和其他电子设备制造业",
"industryCode": "96"
},
{
"industryName": "仪器仪表制造业",
"industryCode": "97"
},
{
"industryName": "食品制造业",
"industryCode": "98"
},
{
"industryName": "废弃资源综合利用业",
"industryCode": "99"
},
{
"industryName": "金属制品、机械和设备修理业",
"industryCode": "100"
},
{
"industryName": "烟草",
"industryCode": "09"
},
{
"industryName": "化学原料和化学制品制造业",
"industryCode": "10"
},
{
"industryName": "燃气生产和供应业",
"industryCode": "11"
},
{
"industryName": "电力",
"industryCode": "12"
},
{
"industryName": "水的生产和供应业",
"industryCode": "101"
},
{
"industryName": "房屋建筑业",
"industryCode": "13"
},
{
"industryName": "土木工程建筑业",
"industryCode": "102"
},
{
"industryName": "建筑安装业",
"industryCode": "103"
},
{
"industryName": "建筑装饰、装修和其他建筑业",
"industryCode": "104"
},
{
"industryName": "装卸搬运和仓储业",
"industryCode": "14"
},
{
"industryName": "铁路运输",
"industryCode": "15"
},
{
"industryName": "道路运输",
"industryCode": "16"
},
{
"industryName": "公交",
"industryCode": "17"
},
{
"industryName": "水上运输",
"industryCode": "18"
},
{
"industryName": "航空",
"industryCode": "19"
},
{
"industryName": "邮政",
"industryCode": "20"
},
{
"industryName": "管道运输业",
"industryCode": "105"
},
{
"industryName": "汽车制造业",
"industryCode": "106"
},
{
"industryName": "互联网和相关服务",
"industryCode": "21"
},
{
"industryName": "电信",
"industryCode": "22"
},
{
"industryName": "软件和信息技术服务业",
"industryCode": "107"
},
{
"industryName": "批发",
"industryCode": "23"
},
{
"industryName": "零售",
"industryCode": "24"
},
{
"industryName": "住宿",
"industryCode": "25"
},
{
"industryName": "餐饮",
"industryCode": "26"
},
{
"industryName": "银行",
"industryCode": "27"
},
{
"industryName": "证券",
"industryCode": "28"
},
{
"industryName": "保险",
"industryCode": "29"
},
{
"industryName": "其他金融业",
"industryCode": "108"
},
{
"industryName": "房地产",
"industryCode": "30"
},
{
"industryName": "租赁",
"industryCode": "31"
},
{
"industryName": "商业",
"industryCode": "32"
},
{
"industryName": "旅游",
"industryCode": "33"
},
{
"industryName": "研究和试验发展",
"industryCode": "34"
},
{
"industryName": "专业技术服务业",
"industryCode": "109"
},
{
"industryName": "科技推广和应用服务业",
"industryCode": "110"
},
{
"industryName": "水利",
"industryCode": "35"
},
{
"industryName": "环保",
"industryCode": "36"
},
{
"industryName": "公共设施管理业",
"industryCode": "37"
},
{
"industryName": "土地管理业",
"industryCode": "111"
},
{
"industryName": "居民服务",
"industryCode": "38"
},
{
"industryName": "机动车、电子产品和日用产品修理业",
"industryCode": "112"
},
{
"industryName": "其他服务业",
"industryCode": "113"
},
{
"industryName": "教育",
"industryCode": "39"
},
{
"industryName": "国防院校",
"industryCode": "114"
},
{
"industryName": "卫生",
"industryCode": "40"
},
{
"industryName": "社会工作",
"industryCode": "41"
},
{
"industryName": "国防医院",
"industryCode": "115"
},
{
"industryName": "医药制造业",
"industryCode": "116"
},
{
"industryName": "广电",
"industryCode": "43"
},
{
"industryName": "文艺",
"industryCode": "44"
},
{
"industryName": "体育",
"industryCode": "45"
},
{
"industryName": "娱乐",
"industryCode": "46"
},
{
"industryName": "文化和旅游",
"industryCode": "117"
},
{
"industryName": "政府",
"industryCode": "47"
},
{
"industryName": "共产党机关及人民政府",
"industryCode": "48"
},
{
"industryName": "公安",
"industryCode": "49"
},
{
"industryName": "监察",
"industryCode": "50"
},
{
"industryName": "民政",
"industryCode": "51"
},
{
"industryName": "司法",
"industryCode": "52"
},
{
"industryName": "财政",
"industryCode": "53"
},
{
"industryName": "人事",
"industryCode": "54"
},
{
"industryName": "国土",
"industryCode": "55"
},
{
"industryName": "海关",
"industryCode": "56"
},
{
"industryName": "税务",
"industryCode": "57"
},
{
"industryName": "质检",
"industryCode": "58"
},
{
"industryName": "工商",
"industryCode": "59"
},
{
"industryName": "统计",
"industryCode": "60"
},
{
"industryName": "气象",
"industryCode": "61"
},
{
"industryName": "地震",
"industryCode": "62"
},
{
"industryName": "海洋",
"industryCode": "63"
},
{
"industryName": "审计",
"industryCode": "64"
},
{
"industryName": "烟草专卖",
"industryCode": "65"
},
{
"industryName": "法院",
"industryCode": "66"
},
{
"industryName": "检察院",
"industryCode": "67"
},
{
"industryName": "新闻",
"industryCode": "42"
},
{
"industryName": "国际组织",
"industryCode": "68"
},
{
"industryName": "其他",
"industryCode": "69"
},
{
"industryName": "综合管理机构",
"industryCode": "118"
},
{
"industryName": "政治工作机构",
"industryCode": "119"
},
{
"industryName": "动员工作机构",
"industryCode": "120"
},
{
"industryName": "政法机构",
"industryCode": "121"
},
{
"industryName": "直属院校",
"industryCode": "122"
},
{
"industryName": "ZQ",
"industryCode": "123"
},
{
"industryName": "LJ",
"industryCode": "124"
},
{
"industryName": "HJ",
"industryCode": "125"
},
{
"industryName": "KJ",
"industryCode": "126"
},
{
"industryName": "HJJ",
"industryCode": "127"
},
{
"industryName": "ZZ",
"industryCode": "128"
},
{
"industryName": "LQ",
"industryCode": "129"
},
{
"industryName": "WJ",
"industryCode": "130"
},
{
"industryName": "融合事务管理机构",
"industryCode": "131"
},
{
"industryName": "退役事务管理机构",
"industryCode": "132"
},
{
"industryName": "融合企业",
"industryCode": "133"
}
]请求:
{
"appId": "bagAMscK57",
"body": {
"authorizeFile": [
{
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
},
{
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
},
{
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
}
],
"entrustFile": {
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
},
"jobPermitFile": {
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
},
"editionFile": [
{
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
},
{
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
}
],
"softnessFile": [
{
"source": "2",
"type": "jpg",
"content": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/8773315f-e7b8-43a6-ba84-22624b1601e2.jpg"
}
]
},
"customerCode": "3",
"industryCode": "04",
"sign": "创蓝文化",
"signType": 1,
"signature": "62bd2e07d1be29ee59b42f89159956baf3a5a138fd618c45f0ab869a9f16ec56",
"timestamp": 1709276995
}响应:
{
"code": "102000",
"message": "请求成功",
"data": {
"signId": "127873750216474624"
}
}二、签名审核结果推送
说明
返回 "ok" (注意:直接返回字符串 ok)
推送参数
| 字段 | 数据类型 | 可选属性 | 描述 |
|---|---|---|---|
| signId | string | M | 签名id |
| status | Integer | M | 审核状态。1审核中 2审核成功 3审核失败 (签名总状态有一个运营商可用即为成功) |
| remark | string | M | 备注 |
| cmccStatus | Integer | M | 移动审核状态。0不可用,1 可用 |
| cuccStatus | Integer | M | 联通审核状态。0不可用,1 可用 |
| ctccStatus | Integer | M | 电信审核状态。0不可用,1 可用 |
对方接收到签名状态后需要返回:"ok"
示例
推送格式:
{
"accountId": "256995",
"cmccStatus": "1",
"ctccStatus": "0",
"cuccStatus": "1",
"pushUrl": "http://rcs-dev.cm253.com/rcs/api/msg/callback_cl",
"remark": "审核成功",
"signId": "1762686661960269824",
"status": 2
}三、查询签名列表
说明
提供查询某一个客户在 RSC 里面申请过的历史签名信息
方法
- 请求方法: POST
- Content-Type:application/json; charset=utf-8
- 请求网址:https://rcs.253.com/rcs/api/v2/template/listSign
参数
| 字段 | 数据类型 | 可选属性 | 描述 |
|---|---|---|---|
| appId | string | M | 发送账号 |
| isByPage | boolean | O | 是否分页查;默认 false |
| pageNo | int | O | 页码,如选择分页查询,未赋值,则默认值为 1 |
| pageSize | int | O | 页大小,如选择分页查询,未赋值,则默认值为 10 |
| auditStatus | int | O | 审核状态: 默认查询全部的。1 审核中 2 审核成功 3 审核失败 |
| timestamp | string | M | 时间戳,1970/1/1 到现在的秒数,10 位 200 秒内请求有效 |
| signature | string | M | 签名 |
返回值
| 字段 | 数据类型 | 描述 |
|---|---|---|
| code | string | 返回码 |
| message | string | 错误描述 |
| data | object | |
| --> id | string | 签名 id |
| --> auditStatus | int | 状态: 1 审核中 2 审核成功 3 审核失败 |
| -->sign | string | 签名 |
| -->resourceFile | string | 资源文件多个以逗号隔开 |
| -->createTime | long | 创建时间 |
| -->cmccStatus | int | 移动可用标识:0不可用,1 可用 |
| -->cuccStatus | int | 移动可用标识:0不可用,1 可用 |
| -->ctccStatus | int | 移动可用标识:0不可用,1 可用 |
| pageNo | int | 页码,未按分页查询的忽略该字段值 |
| pageSize | int | 页大小,未按分页查询的忽略该字段值 |
| totalPages | int | 总页数,未按分页查询的忽略该字段值 |
| totalRecords | int | 总条数,未按分页查询的忽略该字段值 |
示例
请求:
{
"appId": "rDOMKNMLaE",
"isByPage": false,
"pageNo": 3,
"pageSize": 1,
"timestamp": "1635143858",
"signature": "f2a8e86fc9a4f714594e20f1ed1cc87cf986bf9a37da0b6eaf6fb64d094a374a"
}响应:
{
"code": "102000",
"message": "请求成功",
"data": [
{
"id": "1403243377205444608",
"sign": "【上海地阳】",
"auditStatus": 2,
"resourceFile": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/b711077d-302f-4d0c-b333-b515e292cd27.jpg",
"createTime": 1623394262000
},
{
"id": "1393108680487993344",
"sign": "【视频短信测试】",
"auditStatus": 1,
"resourceFile": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/1b9802f4-0370-43a3-b779-19de970b6c36.jpg",
"createTime": 1620977967000
},
{
"id": "1382175702903685120",
"sign": "【上海赛豪文化】",
"auditStatus": 2,
"resourceFile": "http://253-assets.oss-cn-hangzhou.aliyuncs.com/rcs_sms/stable/images/94702458-8816-420a-acdd-c67e57bff8b0.jpg",
"createTime": 1618371342000
}
],
"pageNo": 3,
"totalRecords": 3,
"totalPages": 3,
"pageSize": 1
}错误码
| 错误码 | 说明 |
|---|---|
| 102000 | 成功 |
| 500 | 系统异常 |
| 1002 | 手机号码格式错误 |
| 1003 | 费用扣除失败 |
| 1004 | 白名单 |
| 1005 | 黑名单 |
| 1006 | 手机号超频 |
| 1008 | 用户没有配置通道包 |
| 1010 | 模板不存在 |
| 1013 | 内部错误,创建模板错误 |
| 1015 | 账户余额不足 |
| 1018 | 账户发送超限 |
| 1019 | 手机号为空 |
| 1020 | 未识别的类型 |
| 1301 | AppId 不能为空 |
| 1303 | SubmitNo 不能为空 |
| 1306 | Phones 不能为空 |
| 1311 | TemplateID 不能为空 |
| 1316 | IP 地址限制 |
| 1317 | 账号错误 |
| 1318 | 该模板为动态模板,变量参数不能为空 |
| 1319 | 当前变量模板参数不满足条件:不能重复、最多添加 5 个参数、变量模板参数与提交模板参数个数不一致 |
| 1330 | 模板标题过长,不能超过 20 个字符 |
| 1331 | 短信签名校验失败,请先报备签名 |
| 1332 | appId 或 appSecret 不正确 |
| 1333 | / > < ! ' & script ../ ./ alert 【 这些特殊字符不行 |
| 1334 | 视频短信模板内容不能为空 |
| 1335 | body 中 exType 不能为空,排序不能为空,content 内容不能为空 |
| 1336 | type 和 exType 不匹配或 type 不支持 |
| 1337 | body 大小不能超过 2M |
| 1338 | 通道不存在 |
| 1339 | 当前存在通道不支持变量模板 |
| 1340 | 模板不存在 |
| 1341 | 状态参数错误 |
| 1342 | 必填参数为空 |
| 1343 | submitNo 长度不能超过 32 |
| 1344 | 超过最大限制条数 |
| 1345 | 签名校验错误 |
| 1346 | 时间戳或签名长度过长 |
| 1347 | 时间戳超时 |
| 1348 | 模板名称不能为空 |
这篇文档对您有帮助吗?




