红树服务器5接口文档

《红树服务器5接口文档》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、北京红树科技HTTP接口文档北京红树科技有限公司文档编号产品版本密级2．0共6页HTTP接口文档更新日期：2011年3月25日第9页共9页北京红树科技HTTP接口文档目录1短信发送接口设计21.1发送短信21.2短信发送参数21.3发送返回参数说明32账户余额查询42.1接口地址42.2接口参数43状态报告44上行信息75附录(java开发的接收demo)8第9页共9页北京红树科技HTTP接口文档1短信发送接口设计1.1发送短信为了降低客户的开发技术难度，根据客户需求，提供HTTP接口。采用HTTP的GET(支持po

2、st)方式进行消息的下发。在使用接口时，以如下形式进行调用。http://211.103.155.246:8080/sms_send2.do?corp_id=账户id&corp_pwd=密码&corp_service=业务代码&…………………………………….服务器接口地址：http://211.103.155.246:8080/sms_send2.do账号简单页面测试地址：http://211.103.155.246:8080/smsSubmitTest2.jsp注意事项：1.下发短信时，不要提交错了服务器的接口地址

3、，如果你的账户是开在服务器2上的，提交的时候提交到服务器1的接口地址会返回（106错误：用户名不存在）。2.参数提交后的返回结果为文本格式和xml格式，即，发送完毕后，我方会推送相关数字信息或xml格式的字符串信息。3.服务器支持http方式，为安全性考虑，建议以http方式调用。1.2短信发送参数参数说明：参数名称参数说明备注corp_id企业接口访问id由系统管理员开通corp_pwd系统访问接口密码由系统管理员设定corp_service业务代码由系统管理员分配Mobile要发送的手机号码多个号码用英文的逗号隔

4、开，且群发总号码数不超过50个msg_content短信内容短信内容长度不超过500个汉字每个英文或阿拉伯字符也算1个汉字corp_msg_id用户发送短信自己定义的短信id用于处理群发状态报告可以为空英文和数字的组合总长度不超过50个字节Ext用户自己分配的小号（即显示在接收手机上的主叫尾号，可用于上行信息匹配）例：我们给合作方开的特服号是10657532521924，然后合作方在发送信息的时候可以随意填写扩展号ext=8888，那么用户收到信息时显示的下发号码就是106575325219248888从00000到

5、99999的范围第9页共9页北京红树科技HTTP接口文档说明：1）发送速度：接口的访问间隔是0.1秒，最快访问速度是每秒十次。2）IP：如果用户开账户时指定IP，则接口只接收该IP发送请求。接口编码格式：根据不同开发语言可选用gbk或ISO-8859-1编码（提交信息时，汉字应转成gbk或iso-8859-1提交，否则手机用户收到会显示乱码）1.1发送返回参数说明返回代码代码说明0#数字提交成功#提交成功的手机数量100余额不足101账号关闭102短信内容超过500字或为空或内容编码格式不正确103手机号码超过50个

6、或合法的手机号码为空104用户访问时间间隔低于50毫秒105用户访问方式不是post方式106用户名不存在107密码错误108指定访问ip错误109业务不存在110小号不合法111短信内容内有敏感词常见问题说明：1)长短信：对于长短信，返回的是用户提交的条数，而不是实际扣费的条数，例如用户发送了190字的短信三条，返回的是0#3,后台根据拆分后的结果，计费为9条。2)102错误：确认接口编码格式是否正确，测试标准是发送带有“%”的短信看是否能成功发送。第9页共9页北京红树科技HTTP接口文档1账户余额查询1.1接口地

7、址接口地址：http://211.103.155.246:8888/get_balance.do1.2接口参数参数名称参数说明备注corp_id企业接口访问id由系统管理员开通user_id用户idPwd系统访问接口密码由系统管理员设定说明：支持非一级账户余额查询返回结果为：ok:余额。第9页共9页北京红树科技HTTP接口文档1状态报告用于客户查询每条短信发送的状态是否成功。在收取状态报告之后，请立即调用该接口告知服务端已经成功收取的状态报告编号，否则会重复收取到状态报告接口地址：由合作方提供相应的接收的url，我方

8、主动推送数据。推送的数据样例(为一整条xml格式的字符串，注：是一整条字符串，不是xml文档)test 138100000010(这个参数表示拆分长短