彩信下发
提交方式:
xml格式
建议采用post方式提交请求。
功能:
客户端用Submit命令向服务器端提交MT消息,服务器端返回响应。
请求参数:
请求XML格式示例:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<head><cmdId>002</cmdId><account>8373</account><password>bb43a2c4081bec02fca7b72f38e63021</password></head>
<body><submitMsg><phone>1301234XXXX</phone><title>彩信标题</title><content></content><msgid></msgid><subCode></subCode></submitMsg></body>
</root>
参数名称 | 说明 | ||
---|---|---|---|
head | cmdId | 命令ID,002 or 102 | |
account | 用户账号 | ||
password | 用户密码,需采用MD5加密(32位小写) | ||
body | submitMsg | phone | 一个或多个接收该彩信消息的手机号;手机号之间用英文逗号(,)隔开,不能有重复的手机号码; 如1300112XXXX,1300113XXXX |
title | 彩信标题(发彩信时有效,不能含有特殊字符) | ||
content | 彩信内容:彩信文件压缩成zip文件(zip文件小于90k),再对该文件进行BASE64编码(zip模板在相关示例的java彩信示例的resource文件有) | ||
msgid | 本MT彩信包的唯一标识,32位UUID,可选 | ||
subCode | 扩展子码,可选 | ||
submitMsg | phone | 一个或多个接收该彩信消息的手机号;手机号之间用英文逗号(,)隔开,不能有重复的手机号码; 如1300112XXXX,1300113XXXX |
|
title | 彩信标题(发彩信时有效,不能含有特殊字符) | ||
content | 彩信内容:彩信文件压缩成zip文件(zip文件小于90k),再对该文件进行BASE64编码(zip模板在相关示例的java彩信示例的resource文件有) | ||
msgid | 本MT彩信包的唯一标识,32位UUID,可选 | ||
subCode | 扩展子码,可选 | ||
…… | …… | …… |
该响应为提交响应,发送到手机是否成功请获取状态报告确认该响应为提交响应,发送到手机是否成功请获取状态报告确认
Submit命令的应答内容:
参数名称 | 说明 | |||
---|---|---|---|---|
head | cmdId | 命令ID,802 or 702 | ||
result | 命令是否成功接收。 0:接收成功 其它请参照:彩信提交响应错误码,不等于0时,本响应包中不会有body标签 |
|||
body | submitResult | response | status | 0:接收成功 其它请参照:彩信提交响应错误码 |
phone | 手机号码,对应请求包中的一个手机号码 | |||
msgid | 当result等于0时,该值有效, 本MT彩信包的唯一标识,32位UUID,如果Submit命令请求中msgid不为空且合法,则该值同Submit命令请求中msgid的顺序一致,值一致。 | |||
response | status | 0:接收成功 其它请参照:彩信提交响应错误码 |
||
phone | 手机号码,对应请求包中的一个手机号码 | |||
msgid | 当result等于0时,该值有效, 本MT彩信包的唯一标识,32位UUID,如果Submit命令请求中msgid不为空且合法,则该值同Submit命令请求中msgid的顺序一致,值一致。 | |||
submitResult | response | status | 0:接收成功 其它请参照:彩信提交响应错误码 |
|
phone | 手机号码,对应请求包中的一个手机号码 | |||
msgid | 当result等于0时,该值有效, 本MT彩信包的唯一标识,32位UUID,如果Submit命令请求中msgid不为空且合法,则该值同Submit命令请求中msgid的顺序一致,值一致。 | |||
response | status | 0:接收成功 其它请参照:彩信提交响应错误码 |
||
phone | 手机号码,对应请求包中的一个手机号码 | |||
msgid | 当result等于0时,该值有效, 本MT彩信包的唯一标识,32位UUID,如果Submit命令请求中msgid不为空且合法,则该值同Submit命令请求中msgid的顺序一致,值一致。 |
文档更新时间: 2020-09-30 09:17 作者:夏亮