超级信使http接口说明文档(企业版20101014)

《超级信使http接口说明文档(企业版20101014)》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、上海电信超级信使企业版HTTP接口调用说明深圳协尔信息系统有限公司文档编号产品版本密级3.1产品名称：超级信使共9页广西电信超级信使企业版HTTP接口调用说明拟制：钟波日期：2010/09/09审核：日期：yyyy/mm/dd审核：日期：yyyy/mm/dd批准：日期：yyyy/mm/dd深圳协尔信息系统有限公司版权所有侵权必究版权所有侵权必究第9页共10页上海电信超级信使企业版HTTP接口调用说明历史修改记录时间版本操作人说明06.14V3.0李宗波初稿09.09V3.1钟波修订版权所有侵权必究第9页共10页上海电信超级信使企业版HTTP接口调用说明目录

2、1接口设计31.1HTTP接口约定31.1.1.发送短信31.1.2.接收短信51.1.3.接收状态报告61.1.4.确认收取短信71.1.5.确认收取状态报告8版权所有侵权必究第9页共10页上海电信超级信使企业版HTTP接口调用说明1接口设计1.1HTTP接口约定为了降低客户的开发技术难度，根据客户需求，提供企业版的HTTP接口。采用HTTP的GET(支持post)方式进行消息的下发。在使用接口时，以如下形式进行调用。https://host:port/xx.jsp?xxx=111&yyy=1235&……注意事项：1.短信内容中的中文字符统一采用UTF-

3、8进行URL编码。(java进行编码的方法为：java.net.URLEncoder.encode("短信内容","UTF-8"))2.如果密码中存在特殊字符，也需要URL编码处理。3.返回结果为纯文本方式和xml格式两种。4.在返回结果中，需要去除前后多余的空白行。5.(服务器支持https方式，为安全性考虑，建议以https方式调用)6.用于文本分割的分割符号均为英文字符，比如逗号和分号。7.xml方式返回结果中，所有中文字符已经经过xml转义处理。8.xml元素中的值，也需要先去除前后的空白字符。(使用trim方法)广西超级信使域名：http://q

4、xt.gx.vnet.cn/接口使用的端口为：80801.1.1.发送短信企业版账号发送短信。入口地址：http://ip:port/httpinterface/ent/sendsms.jsp说明：该接口提供了二个功能。发送单条短信和发送多条短信。参数说明：1．发送单条短信所需参数如下：参数长度（字节）类型说明srcmobile企业号长度字符串发送消息的企业账号password密码长度字符串账号对应的登录密码objmobile目标号码长度字符串目标号码，小灵通需加区号，移动，联通则为手机号码如：02127490194,13712345678,1301234

5、5678smsid20(不低于20，不超过36)字符串当前短信的消息编号，全部由数字组成接收状态报告的时候用到，该消息编号的格式为目标号码+当前时间戳整数，精确到毫秒。供收取状态报告用.如0212749019420060801121120版权所有侵权必究第9页共10页上海电信超级信使企业版HTTP接口调用说明smstext140字符串需要发送的短信内容。采用UTF-8对URL进行编码。长度限制是指url解码后的短信内容长度。rstype20字符串可选参数，“text”，返回结果为普通字符串格式,“xml”,返回结果为xml格式。不填该参数，则默认为text

6、格式2发送多条短信所需参数如下：参数长度（字节）类型说明srcmobile企业号长度字符串发送消息的企业账号password密码长度字符串账号对应的登录密码objmobiles500字符串该参数用于一次发送多条短信，格式为目标号码+逗号+消息编号+分号；可以重复出现多次。目标号码:小灵通需加区号，移动，联通则为手机号码消息编号:全部由数字组成接收状态报告的时候用到，该消息编号的格式为目标号码+当前时间戳整数，精确到毫秒。供收取状态报告用如:02198765432,02198765432150269461937;smstext不多于140字符串需要发送的短信

7、内容。采用UTF-8对URL进行编码。长度限制是指url解码后的短信内容长度。rstype20字符串可选参数，“text”，返回结果为普通字符串格式,“xml”,返回结果为xml格式。不填该参数，则默认为text格式返回结果：值含义0成功-1失败-2缺少源号码-3缺少密码-4缺少短信内容-5缺少目标号码-6缺少短信编号-7企业账号登录失败-8短信内容太长调用接口示例：1.发送单条短信:sendsms.jsp?srcmobile=02112345678&password=123789&objmobile=02198765432&smsid=021987654

8、32150269461937&smstext=%E6%B5%8B%