模板上传

功能描述

上传包含文字、图片、视频、音频等内容的富媒体短信模板。

调用格式

• 请求方式：POST
• 接口地址：http://ip:port/sms/templateAdd

• 其中 ip:port 由平台在开户后提供。

请求参数（form 表单）

参数名	类型	必填	说明
spid	string	是	企业 ID
login	string	是	登录账号
pwd	string	是	MD5(login + password)（32 位大写）
name	string	是	模板名称
content	string	是	模板内容，JSON 字符串（需 URL 编码）

content 结构说明

{
  "subject": "模板标题",
  "mmsbody": [
    {
      /* 文字帧 */
    },
    {
      /* 图片帧 */
    },
    {
      /* 视频帧 */
    },
    {
      /* 音频帧 */
    }
  ]
}

文字帧对象

字段	值	说明
type	"text"	固定值
extType	"txt"	固定值
body	string	文本内容

图片帧对象

字段	值	说明
type	"image"	固定值
extType	"jpg", "png" 等	支持常见图片格式
body	base64 编码字符串	图片二进制转 Base64

视频帧对象

字段	值	说明
type	"video"	固定值
extType	"mp4", "3gp"	支持格式
body	base64 编码	视频文件 Base64

音频帧对象

字段	值	说明
type	"media"	固定值
extType	"mp3", "aac" 等	支持音频格式
body	base64 编码	音频文件 Base64

⚠️ 动态模板规范

• 可使用最多 5 个变量，格式为 {$v1}, {$v2}, ..., {$v5}
• 发送时将按顺序替换，最终字数以替换后为准

动态模板示例

尊敬的{$v1}，您是我行{$v2}级会员，点击 {$v3} 查看详单，回 T 退订。

请求示例（已 JSON 化，实际需 URL 编码）

{
  "spid": "1000",
  "login": "dh****",
  "pwd": "E717EBFD5271EA4A98BD38653C01113D",
  "name": "超级短信模板",
  "content": "{\"subject\":\"test1\",\"mmsbody\":[{\"type\":\"text\",\"extType\":\"txt\",\"body\":\"你好\"},{\"type\":\"image\",\"extType\":\"jpg\",\"body\":\"iVBORw0KGgoAAAANSUhEUgAAAWAAAAFgCAYAAACFYaNMAAAABGdBTUEAALGPCYII=\"}]}"
}

响应示例

{
  "result": "0",
  "desc": "提交成功",
  "templateId": "200217112800100001"
}

返回参数

参数名	说明
result	0 表示成功，非 0 表示失败
desc	结果描述
templateId	模板唯一编号