彩信下发

访问地址:http://mms.3tong.net/http/mms

提交方式:

xml格式
建议采用post方式提交请求。

功能:

客户端用Submit命令向服务器端提交MT消息,服务器端返回响应。

请求参数:

请求XML格式示例:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<head><cmdId>002</cmdId><account>dh***</account><password>0243614f784a8cfa94a94b85cbee7540</password></head>
<body><submitMsg><phone>1301234XXXX</phone><title>彩信标题</title><content></content><msgid></msgid><subCode></subCode></submitMsg></body>
</root>

参数名称 说明
head cmdId 命令ID,002
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 扩展子码,可选
…… …… ……

该响应为提交响应,发送到手机是否成功请获取状态报告确认该响应为提交响应,发送到手机是否成功请获取状态报告确认

响应格式示例:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <head>
    <cmdId>802</cmdId>
    <result>0</result>
  </head>
  <body>
    <submitResult>
      <response>
        <status>0</status>
        <msgid>11223344</msgid>
        <phone>13000000000</phone>
      </response>
    </submitResult>
  </body>
</root>

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的顺序一致,值一致。
文档更新时间: 2024-08-28 09:10   作者:夏亮