彩信下发
提交方式：
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 | |
| 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的顺序一致，值一致。 | |||
文档更新时间: 2021-01-29 11:01 作者：夏亮
