彩信下发

访问地址：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   作者：夏亮