OFCARD系统http接口协议（V6.1）.doc

OFCARD系统http接口协议(V6.1) 本版本最后修订日期： 2013年03月26日 版本号 日期 说明 作者 4.0 2008-12-15 增加版本号字段，SP接入密码修改为账户密码的MD5值 5.0 2009-5-7 增加游戏区服接口，开通电信手机充值 5.1 2009-01-08 修正商品对应分类错误 5.2 2010-7-13 增加买家IP字段 5.3 2011-01-13 订单查询地址变动 5.4 2011-08-23 接口域名变动（新接口用户启用） 5.5 2011-09-26 增加移动慢充接口 2011-09-28 增加根据手机号和面值查询商品信息/api/），SP使用该接口之前必须注册成经销商或者直销商，提供SP服务器IP地址，通知欧飞工作人员开通Http接口功能，欧飞为你分配相应功能模块和MD5 key值，你的登陆密码不能设置的太简单，请不要向任何人，包括欧飞工作人员泄露你的直销系统登陆密码。 欧飞针对本协议接口没有架设测试环境，拿到该接口的SP，请直接进入生产环境（地址和端口详见各个功能模块）进行测试，SP注册后可以自行购买一定数量的信用点（信用点可以理解成预存款，没有信用点的情况下，SP无法进行提卡和充值），建议用编码为360101的测试卡进行提卡测试，用Q币进行充值测试。 SP可以登陆欧飞直销系统查看交易记录进行对帐，也可以使用对帐接口进行自动对帐。 关于接口的另外几点说明： 该接口使用HTTP协议，请求数据传输格式如下： 【接口URL】?【参数名称1】=【参数值1】【参数名称2】=【参数值2】…… 2、所有接口的应答在HTTP包体中将以XML形式返回； 3、所有的接口请求通过后台调用； 4、各参数的参数名全部为小写； 5、欧飞服务器是放在电信机房，如果合作伙伴需要更快的接入速度，最好放在电信机房 6．其中文档提到的“+”是连接字符的意思。 7.接口调用出现超时或其它错误时，需联系我们客服，或者主动到平台进行核实。 协议的交互逻辑 1用户信息查询接口（queryuserinfo.do） 此接口可以查询到SP用户的信用点余额，可以提醒SP进行补充信用点： 请求参数： 说明 userid SP编码如（A00001），可由SP自动注册生成,在登陆系统时得到以A开头的编号 userpws SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) version 固定值为：6.0(不参与MD5验证) 响应的XML标签说明 说明 err_msg 错误描述，如请求得到正确返回，此处将为空 retcode 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 ret_leftcredit 账户剩余金额 调用的链接如下： /queryuserinfo.do?userid=Axxxxxuserpws=xxxxxxxversion=6.0 返回的XML： ???xml version=1.0 encoding=GB2312 ? - userinfo ? err_msg / ? retcode1/retcode ? ret_leftcredit352328.97/ret_leftcredit ? useridAXXXXX/userid ? /userinfo 2查询所有商品大类（querybigcard.do） 此接口用于查询所有商品的大类信息 调用的链接如下： /querybigcard.do 返回的内容： ?xml version=”1.0” encoding=”GB2312” ? cardinfo err_msg / retcode1/ retcode ret_cardinfos card ? classid23/classid // 大类编码 cardname游戏辅助卡? /ret_cardinfos ?/cardinfo 3商品小类信息同步接口（querylist.do） 此接口依据用户提供的商品大类编码返回此中的小类列表和小类信息（可以同步到本地，定时维护，不用每次都去查询）： 请求参数： 说明 userid SP编码如（A00001）在登陆系统时得到以A开头的编号 userpws SP接入密码(为账户密码的MD5值，如登陆密码为111111,此时这个值为md5(“111111”) (32位小写) cardid 需查询商品的编码（支持2位，4位编码，2位表示该大类下的所有商品，4位是具体的小类商品） (21 游戏卡密、22 游戏直充、14 移动话费、15 联通话费、19 电信话费) version 固定值为：6.