HTTP短信接口文档

1、短信接口说明书PAGE PAGE 6HTTP短信接口文档版本：version4.1 最新修改时间:2016-12-27Ip:3目录 TOC o 1-3 h z u HYPERLINK l _Toc295022719 1.1发送短信 PAGEREF _Toc295022719 h 3 HYPERLINK l _Toc295022720 1.1.1发送短信格式 PAGEREF _Toc295022720 h 3 HYPERLINK l _Toc295022721 1.1.2发送短信参数说明 PAGEREF _Toc295022721 h 3 HYPERLINK l _Toc295022722 1.

2、1.3发送短信响应包 PAGEREF _Toc295022722 h 3 HYPERLINK l _Toc295022723 1.1.4发送短信响应包参数说明： PAGEREF _Toc295022723 h 3 HYPERLINK l _Toc295022724 1.2接收短信状态报告 PAGEREF _Toc295022724 h 4 HYPERLINK l _Toc295022725 1.2.1接收状态报告格式 PAGEREF _Toc295022725 h 4 HYPERLINK l _Toc295022726 1.2.2接收状态报告参数说明 PAGEREF _Toc295022726

3、 h 4 HYPERLINK l _Toc295022727 1.2.3接收状态报告响应包 PAGEREF _Toc295022727 h 4 HYPERLINK l _Toc295022728 1.2.4接收状态报告响应包参数说明 PAGEREF _Toc295022728 h 5 HYPERLINK l _Toc295022729 1.3接收短信 PAGEREF _Toc295022729 h 5 HYPERLINK l _Toc295022730 1.3.1接收短信格式 PAGEREF _Toc295022730 h 5 HYPERLINK l _Toc295022731 1.3.2接收

4、短信参数说明 PAGEREF _Toc295022731 h 5 HYPERLINK l _Toc295022732 1.3.3接收短信响应包 PAGEREF _Toc295022732 h 5 HYPERLINK l _Toc295022733 1.3.4接收短信响应包参数说明 PAGEREF _Toc295022733 h 6 HYPERLINK l _Toc295022734 1.4查询余额 PAGEREF _Toc295022734 h 6 HYPERLINK l _Toc295022735 1.4.1查询余额格式 PAGEREF _Toc295022735 h 6 HYPERLINK

5、 l _Toc295022736 1.4.2查询余额参数说明： PAGEREF _Toc295022736 h 6 HYPERLINK l _Toc295022737 1.4.3查询余额响应包 PAGEREF _Toc295022737 h 6 HYPERLINK l _Toc295022738 1.4.4查询余额响应包参数说明 PAGEREF _Toc295022738 h 6 发送短信发送短信格式（HTTP GET或者HTTP POST）http:/ip:18002/send.do?ua=xxx&pw=xxx&mbms=A&ex=01&tm=xxx&dm=xxxx

6、注意：接入之后最好向管理员申请ip地址绑定，这样能防止被恶意尝试造成账号泄露或被锁定（密码连续错误10次将被锁定）发送短信参数说明ua：用户名pw：密码密码值为md5（pw+tm），tm设置为当前时间，与标准时间误差不能超过30分钟。（注：中间的+号在实际赋值时不要填写， tm格式yyyymmddhhmiss共14位）mb：目的手机号，多条请用英文逗号隔开，最多10000个号码ms：发送内容，如果含有空格，百分数等特殊内容，请用utf8方式进行编码，最多500个文字（1个英文或数字也算1个文字）ex：发送扩展号，对于可扩展的通道，可以根据需要任意扩展，但发送出去总长度不会超过20位，可选参数。

7、tm：当前时间，格式：yyyymmddhhmissdm：定时时间（可以为空），格式：yyyymmddhhmiss发送短信响应包格式举例：0,1112090856000110意义：返回值,消息编号发送短信响应包参数说明：注意：响应包里没有账号密码是否正确、是否余额不足、账号状态是否正确的提醒，请通过余额查询接口来做相应检测，如果发生这种情况，管理员会第一时间通知您；同样的内容对同一个号码发多条，系统会自动去重，这样做是为了避免因重复发送造成的投诉；返回值含义0发送成功-1ua或密码为空-2下发号码为空-3下发内容为空-4内容超长-5下发号码超长-6ua或密码不正确-7余额不足-8IP地址鉴权不对

8、-9协议类型不对-99系统异常接收短信状态报告接收状态报告格式（多条POST方式，每次最多100条记录） 地址：rpturl（接入方提供，可以在管理后台自助配置）格式：rpturl?data=msgid,mobile,stat|msgid,mobile,stat|msgid,mobile,stat举例：rpturl?data=05201617404137DELIVRD|05220128211118DELIVRD|05220141501133MK:0010接收状态报告参数说明rpturl：由接入方提供的接收状态报告的地

9、址，通道方把状态报告（消息编号、状态、手机号码，特服号）的数据传给此地址id：消息IDst：短信状态报告，stat=DELIVRD表示用户成功接收短信。mb：手机号码。接收状态报告响应包响应“0”即可接收短信接收短信格式（单条POST方式，每次1条记录）地址：mourl（接入方提供，可以在管理后台自助配置）格式：mourl?mb=xxx&sc=xxx&ms=xxx举例：mourl?mbsc=10690001&ms=你好，测试接收短信参数说明mourl：由合作方提供的接收上行的地址，通道方把用户回复的短信数据（手机号、特服号、内容）传给此地址。mb：手机号sc：特服号ms：内容（utf8编码）接收短信响应包响应 0 即可。查询余额查询余额格式HYPERLINK http:/ip:18005/balance.do?u