请在已开通API账号及文本短信后再申请开通本接口
开通账号：https://www.0654.cn/223.html
开通API：https://www.0654.cn/73.html
需要特别注意：彩信接口发送时必须先提交彩信模板ID通过后才能申请发送
彩信模板素材也可以通过客服提交审核通过后获取彩信模板ID
发送接口（模板彩信）
前置说明：如您的网关或者post请求需要HTTPS加密访问
请将 http://120.26.69.132:7891/ 替换为 https://ffsms.0654.cn/
如无需https请求，请保持默认URL
采用 HTTP POST 发送模式
URL
http://120.26.69.132:7891/api/v1/mms/batchSend
协议
HTTP POST
编码格式
utf-8
Content-Type
application/x-www-form-urlencoded （Params 传参）
application/json （Body JSON 传参）
传入参数
| 参数 | 是否必须 | 类型 | 描述 |
| account | 必填 | string | 账号 |
| pwd | 必填 | string | 接口密码，MD5加密后的值 |
| templateId | 必填 | string | 彩信模板Id |
| data | 必填 | Array | 用户发送数据列表，最大不超过3000个 |
| taskId | 非必填 | string | 自定义批次id，全局唯一 |
| extNo | 非必填 | string | 用户自定义拓展子号，只能为正整数 |
data字段说明
| 参数 | 是否必须 | 类型 | 描述 |
| mobile | 必填 | string | 手机号 |
| content | 非必填 | string | 文本变量 |
请求参数
{
“account”: “账号”,
“pwd”: “MD5接口密码”,
“taskId”: “xxx”,
“extNo”: “”, “templateId”:
“彩信模板id”, “data”: [
{
“mobile”: “手机号1”,
“content”: “变量1,变量2”
},
{
“mobile”: “手机号2”,
“content”: “变量1,变量2”
}
]
}
返回参数
“code”: “00”,
“message”: “成功”,
“data”: {
“taskId”: “27b9a4f28301416eb8b34bc9432a190a”, //当前任务批次id “createDate”: “2025-02-25” //提交日期
}
}
彩信模板审核提交接口
采用 HTTP POST 发送模式
URL
http://120.26.69.132/:7891/api/v1/tpl/tplUpload
协议
HTTP POST
编码格式
utf-8
Content-Type
application/json（Body JSON 传参；当前接口仅支持 JSON，不支持 Params 传参）
传入参数
| 参数 | 是否必须 | 类型 | 描述 |
| account | 必填 | string | 账号，全局统一 |
| pwd | 必填 | string | 接口密码，MD5加密后的值 |
| title | 必填 | string | 彩信模板主题 |
| reslist | 必填 | array | 彩信资源列表，按数组顺序组合为模板内容 |
reslist字段说明
| 参数 | 是否必须 | 类型 | 描述 |
| type | 必填 | string | 资源类型。文本帧支持 text/txt；图片支持jpg/jpeg/png/gif；视频支持 mp4/3gp；音频支持mp3/wav，建议统一小写。 |
| name | 条件必填 | string | 文件资源名称。非文本资源建议必传；如无后缀，平台按 type 自动补默认后缀。文本帧可不传。 |
| source | 条件必填 | string | 非文本资源必填。source=file 表示 content 为纯base64；其他值按资源 URL 下载。文本帧当前代码不使用该字段，可不传。 |
| content | 必填 | string | 文本帧传文本内容；文件资源 source=file 时传纯base64 字符串；URL 资源传可访问的资源地址。 |
变量模板说明
如需创建彩信变量模板，请在文本帧 content 中定义变量，占位符格式为 {%参数key%}。
参数key不可为空，且同一模板内不可重复；两个变量不能直接相邻，需要在变量之间加入分隔字符。
示例：尊敬的{%name%}，您的订单{%orderNo%}已发货，请查收。
变量模板审核通过后，调用模板彩信发送接口时，data.content 按变量在文本中出现的顺序传入变量值，多个变量值使用英文逗号分隔；例如：张三,NO20260417001。
创建成功后，返回 data 直接表示平台模板ID。
请求参数示例（普通模板）
{
“account”: “账号”,
“pwd”: “MD5接口密码”,
“title”: “彩信模板测试001”,
“reslist”: [
{
“type”: “txt”,
“name”: “content.txt”,
“content”: “您好，这是一条彩信模板测试。”
},
{
“type”: “png”,
“name”: “test.png”,
“source”: “file”,
“content”: “iVBORw0KGgoAAAANSUhEUgAA… （此处填写纯base64字符串） ” }
]
}
请求参数示例（变量模板）
{
“account”: “账号”,
“pwd”: “MD5接口密码”,
“title”: “彩信变量模板测试001”,
“reslist”: [
{
“type”: “txt”,
“name”: “content.txt”,
“content”: “尊敬的{%name%}，您的订单{%orderNo%}已发货， 请查收。”
},
{
“type”: “png”,
“name”: “test.png”,
“source”: “file”,
“content”: “iVBORw0KGgoAAAANSUhEUgAA… （此处填写纯base64字符串） ” }
]
}
返回参数
| 参数 | 是否必须 | 类型 | 描述 |
| code | 是 | string | 返回码。00=成功，其他值=失败 |
| message | 是 | string | 返回说明 |
| data | 否 | integer | 成功时返回平台模板ID，审核通过后可在模板彩信发送接口中作为 templateId 使用 |
返回示例
{
“code”: “00”,
“message”: “成功”, “data”: 10
}
3号通道网页使用链接：https://td3.0654.cn/
反馈与建议
有任何问题请与我们联系
- 邮箱：sms@2014idc.com
- 电话：132 6543 4321