签名管理
更新时间:2026-09-14 10:35:00
说明
参数列表的可选属性 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 | 行业属性编码,请查枚举例子 |
| signCategory | string | M | 签名分类 1企业名称 2 app 3 商标 4其他(如政企) |
| signType | string | M | 签名类型:0 非商标类;1 商标类 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 | 商标授权文件列表(最多 5 个,选填) |
| entrustFile | MaterialParam | M | 委托书文件(最多 1 个) |
| jobPermitFile | MaterialParam | M | 营业执照文件(最多 1 个) |
| softnessFile | List< MaterialParam> | C | 商标注册证文件列表 (最多 5个,signType=1 商标类时必传) |
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" } }
二、查询签名列表
说明
提供查询某一个客户在 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 }
三、签名审核结果推送
说明
返回 "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 }
错误码
| 错误码 | 说明 |
|---|---|
| 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 | 模板名称不能为空 |
这篇文档对您有帮助吗?




