奥软短信网关接口HTTP.DOC

短信网关接口(HTTP) 用户指南 北京盛世云商网络技术有限公司 2011年10月 HTTP接口说明 1、MT接口（下发接口） 发送时调用页面：:8080/sendsms/ 使用GET方法，GET时设置下列参数： 参数 是否可选 描 述 username 必选 pwd 必选1319873904) url传送密码为5a1a023fd486e2f0edbc595854c0d808 md5加密串要求为小写 [密码只能为字母和数字] mobiles 必选 必选msg=【签名】短信内容 code 可选必选1319873904 [1970年到现在的秒数] [两台服务器时差不超过3600秒] rpttype 可选,不填或值为：txt 返回txt格式 值为：xml 返回Xml格式 值为：json 返回Json格式 linkid 可选:8080/sendsms/?username= wang pwd=5a1a023fd486e2f0edbc595854c0d808dt=1319873904msg=test mobilesode=1028 :8080/sendsms/?username= wang pwd=5a1a023fd486e2f0edbc595854c0d808dt=1319873904msg=test mobiles13838882929ode=1028 [注] 1,若不需要code参数可以写为 code= 或者不带code参数 2,参数全用urlencode转码，传输中参数全用utf-8编码 3,短信内容需要在内容前加上签名。签名括号“【】”，具体签名内容需事先向我方备案. 返回值说明(xml或json) 参数名称 参数说明 备注 reqCode 返回值 返回值，参见 错误码定义 reqMsg 返回值说明 返回值说明 reqId 提交批次ID 匹配状态报告使用 2、MO接口 本接口仅针对已开通回复网关的用户. 如需被动接收消息接口,则需提供接收消息的地址.云商短信平台将传递MOBILE和MSG两个参数到接收地址. url/?mobiles=1391234567msg=23223432432username=wangpwd=5a1a023fd486e2f0edbc595854c0d808dt=1319873904code=1028 code为自定义端口号 接收方在收到正确信息后，请返回0 我方设置超时为3秒，如果发送不成功会隔1秒补发1次，总共发3次，如果3次都不能发送成功，信息将自动丢弃 3、得到短信库存量 :8080/getsmsnum/?username=wangpwd=5a1a023fd486e2f0edbc595854c0d808dt=1319873904 返回结果为剩余短信量。 4、REPORT接口 本接口仅针对已开通回复状态报告的用户. 如需被动接收状态报告,则需提供接收消息的状态报告.奥软将传递MOBILE和STATUS两个参数到接收地址. url/?mobiles=1391234567status=DELIVRDusername=wangpwd=5a1a023fd486e2f0edbc595854c0d808dt=1319873904code=10690091228 code为下发时的长号码 接收方在收到正确的状态报告后，请返回0 status=DELIVRD时为下发成功，status不为DELIVRD是表示下发失败 5、错误码定义 值 描述 0 发送成功 -1 一次发送的手机号码过多 -2 登录账户错误 -3 密码错误 -4 余额不足 -5 超时[注意检查服务器系统时间] -6 code参数不合法 -7 用成POST了，正确应该是GET -8 username参数丢失 -9 pwd参数丢失 -10 msg参数丢失 或者 msg为空信息 或 msg 编码不对 -11 mobiles参数丢失 -12 dt参数丢失 -13 一次下发短信超过了400个字 -14 mobiles参数不对 不是正确电话号 -15 IP鉴权失败 -16 对同一手机号发送相似内容条数限制 ~-100 其他错误 接入步骤： 认真阅读该技术文档 业务人员把参数进行分配设置 开发人员进入短信后台设置自己的参数，并根据测试地址开发 后台地址为: 开发人员开发测试 ================以下内容供开发参考==================== 如何在不同编程语言中获取现在的Unix时间戳(Unix timestamp)？/Tools/unixtime.aspx Ja