logo
logo
请输入关键词搜索产品或者文档
中国

中国站

创蓝云智

国际站

Innopaas

签名管理

更新时间:2026-07-30 11:27:39

说明

参数列表的可选属性 M:表示必选。 O:表示任意可选。 C:表示条件可选。

一、创建签名

说明

创建签名接口。

方法

参数

Body:

字段数据类型可选属性描述
appIdstringM发送账号
signstringM签名名称
customerCodestringM所属客户编码,请查枚举例子
industryCodestringM行业属性编码,请查枚举例子
signTypestringM签名类型 0:非游戏类1:游戏类
timestampstringM时间戳。格式:System.currentTimeMillis() / 1000
signaturestringM验签签名,参与字段由appId、sign、customerCode、industryCode、signType、timestamp组成
bodySignMaterialBodyM素材body
businessNamestringC企业名称
creditCodestringC统一社会信用代码
handledbyNamestringC经办人
relevantIdcardstringC经办人身份证号

SignMaterialBody:

字段数据类型可选属性描述
authorizeFileList< MaterialParam>M授权文件。限制3个,
entrustFileMaterialParamM委托书文件。限制1个
jobPermitFileMaterialParamM营业执照文件。限制1个
editionFileList< MaterialParam>C网终游戏出版物号。限制10个。当签名为游戏类时必传。
softnessFileList< MaterialParam>C软件著作权登记证书。限制10个。当签名为游戏类时必传。

MaterialParam:

字段数据类型可选属性描述
sourcestringM素材来源,1:base64(默认) 2:url
typestringM素材格式 eg:png
contentstringM素材具体内容:具体的base64 或 具体的url

返回值

字段数据类型描述
codestring返回码
messagestring错误描述
dataobject
--> signIdstring签名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)

推送参数

字段数据类型可选属性描述
signIdstringM签名id
statusIntegerM审核状态。1审核中 2审核成功 3审核失败 (签名总状态有一个运营商可用即为成功)
remarkstringM备注
cmccStatusIntegerM移动审核状态。0不可用,1 可用
cuccStatusIntegerM联通审核状态。0不可用,1 可用
ctccStatusIntegerM电信审核状态。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 里面申请过的历史签名信息

方法

参数

字段数据类型可选属性描述
appIdstringM发送账号
isByPagebooleanO是否分页查;默认 false
pageNointO页码,如选择分页查询,未赋值,则默认值为 1
pageSizeintO页大小,如选择分页查询,未赋值,则默认值为 10
auditStatusintO审核状态: 默认查询全部的。1 审核中 2 审核成功 3 审核失败
timestampstringM时间戳,1970/1/1 到现在的秒数,10 位 200 秒内请求有效
signaturestringM签名

返回值

字段数据类型描述
codestring返回码
messagestring错误描述
dataobject
--> idstring签名 id
--> auditStatusint状态: 1 审核中 2 审核成功 3 审核失败
-->signstring签名
-->resourceFilestring资源文件多个以逗号隔开
-->createTimelong创建时间
-->cmccStatusint移动可用标识:0不可用,1 可用
-->cuccStatusint移动可用标识:0不可用,1 可用
-->ctccStatusint移动可用标识:0不可用,1 可用
pageNoint页码,未按分页查询的忽略该字段值
pageSizeint页大小,未按分页查询的忽略该字段值
totalPagesint总页数,未按分页查询的忽略该字段值
totalRecordsint总条数,未按分页查询的忽略该字段值

示例

请求:

{
  "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未识别的类型
1301AppId 不能为空
1303SubmitNo 不能为空
1306Phones 不能为空
1311TemplateID 不能为空
1316IP 地址限制
1317账号错误
1318该模板为动态模板,变量参数不能为空
1319当前变量模板参数不满足条件:不能重复、最多添加 5 个参数、变量模板参数与提交模板参数个数不一致
1330模板标题过长,不能超过 20 个字符
1331短信签名校验失败,请先报备签名
1332appId 或 appSecret 不正确
1333/ > < ! ' & script ../ ./ alert 【 这些特殊字符不行
1334视频短信模板内容不能为空
1335body 中 exType 不能为空,排序不能为空,content 内容不能为空
1336type 和 exType 不匹配或 type 不支持
1337body 大小不能超过 2M
1338通道不存在
1339当前存在通道不支持变量模板
1340模板不存在
1341状态参数错误
1342必填参数为空
1343submitNo 长度不能超过 32
1344超过最大限制条数
1345签名校验错误
1346时间戳或签名长度过长
1347时间戳超时
1348模板名称不能为空
24小时热线 400-9669-253