模板管理
更新时间:2026-07-31 10:01:40
一、创建模板
-
Content-Type: application/json
-
请求方式: json 格式封装的字符串,采用 post 方式提交请求
-
编码格式: utf-8
完整公共请求头、CheckSum 验签算法统一参考:API调用说明
说明
创建视频短信模板,提交模板是变量模板时,变量模板仅文本可添加变量,且最多包含 5 个变量,顺序依次为:${v1}、${v2}、${v3}、${v4}、${v5}
请求体 body
| 参数名称 | 参数类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| templateName | String | 是 | 模板名称 | 视频短信模板 |
| sign | String | 是 | 已经在平台创建的签名 | 【视频短信测试】 |
| body | List | 是 | 模板内容列表 | 见下方嵌套参数 |
| → type | String | 是 | 媒体类型:text / video / audio / image | text |
| → exType | String | 是 | 后缀格式,和 type 配合使用 text:txt video:mp4/3gp audio:mp3 image:jpg/gif/png | txt |
| → content | String | 是 | 文本素材直接传内容,文件素材时(图片、视频、音频等等),可传 base64 和文件 url,根据 contentType 指定 | 变量一 ${v1} |
| → contentType | Int | 条件 | content 类型(文本不考虑该值)。如果是文件时,1:base64,2:文件素材 url。不传默认是:1 | 1 |
| → sort | Int | 是 | 内容排序 | 1 |
| isDynamic | Int | 条件 | 动态模板标记,当创建动态模板时此字段为必须 | 1 |
| templateLink | String | 条件 | 模板链接完整示例 |
接口响应
响应体 body
| 参数名称 | 参数类型 | 描述 | 示例 |
|---|---|---|---|
| code | String | 返回码 | "102000" |
| msg | String | 错误描述 | "请求成功" |
| requestId | String | 请求id | 32位uuid |
| data | Object | ||
| → templateId | String | 模板 id | 127873750216474624 |
请求示例
{ "body": [ { "exType": "txt", "content": "变量一 ${v1},变量二 ${v2},变量三 ${v3},变量四 ${v4},变量五 ${v5},拒收请回复R", "sort": 1, "type": "text" } ], "templateName": "视频短信模板", "sign": "【视频短信测试】", "isDynamic": 1 }
响应示例
{ "code": "102000", "msg": "请求成功", "requestId": "32位uuid", "data": { "templateId": "127873750216474624" } }
二、查看模板状态
-
接口url: https://rcs.253.com/videosms/api/v2/template/getSingleTemplateInfo
-
Content-Type: application/json
-
请求方式: json 格式封装的字符串,采用 post 方式提交请求
-
编码格式: utf-8
完整公共请求头、CheckSum 验签算法统一参考:API调用说明
说明
查询模板状态。
请求体 body
| 参数名称 | 参数类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| templateId | String | 是 | 模板 id | 1410869910296330240 |
接口响应
响应体 body
| 参数名称 | 参数类型 | 描述 | 示例 |
|---|---|---|---|
| code | String | 返回码 | "102000" |
| msg | String | 错误描述 | "请求成功" |
| requestId | String | 请求id | 32位uuid |
| data | Object | ||
| → statusName | String | 模板状态说明 | "审核成功" |
| → status | Int | 模板状态:1 平台审核中 2 运营商审核中 3 审核成功 4 审核失败 | 3 |
| → templateId | String | 模板 id | 146351173975146503 |
| → operator | String[] | 模板可发运营商标识:1 移动 2 联通 3 电信 | ["2", "1", "3"] |
| → rejectReason | String | 审核驳回原因 | |
| → expireFlag | String | 模板有效性:0 失效 1 有效 | |
| → isDynamic | String | 动参或非动参标识:0 非动参 1 动参 |
请求示例
{ "templateId": "1410869910296330240" }
响应示例
{ "code": "102000", "msg": "请求成功", "requestId": "32位uuid", "data": { "statusName": "审核成功", "templateId": "146351173975146503", "operator": ["2", "1", "3"], "status": 3 } }
三、模板审核结果推送
-
推送方式: POST,创蓝服务器主动推送至用户配置的回调地址
-
Content-Type: application/json
-
编码格式: utf-8
说明
模板审核结果推送,对方接收到状态报告后需要返回:"ok"(直接返回字符串 ok)。
推送参数
| 参数名称 | 参数类型 | 描述 | 示例 |
|---|---|---|---|
| templateId | String | 模板 id | 146xxxxxx23243 |
| status | Int | 模板状态:1 平台审核中 2 运营商审核中 3 审核成功 4 审核失败 | 3 |
| remark | String | 审核备注/说明 | 审核成功 |
| time | String | 推送时间,格式 yyyyMMddHHmmss | 20201030111523 |
| cmccStatus | Int | 移动审核状态:1 审核中 3 审核成功 4 审核失败 | 3 |
| cuccStatus | Int | 联通审核状态:1 审核中 3 审核成功 4 审核失败 | 3 |
| ctccStatus | Int | 电信审核状态:1 审核中 3 审核成功 4 审核失败 | 3 |
| expireFlag | String | 模板有效性:0 失效 1 有效 | 1 |
推送示例
{ "templateId": "146xxxxxx23243", "status": 3, "remark": "审核成功", "time": "20201030111523", "cmccStatus": 3, "cuccStatus": 3, "ctccStatus": 3, "expireFlag": "1" }
⚠️ 对方接收到推送后需要返回字符串 "ok"
这篇文档对您有帮助吗?




