DOC《OFCARD系统http接口协议（V6.1）》

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 增加根据手机号和面值查询商品信息 2012-04-18 增加身份证核查接口 2012-05-26 增加固话查询和充值接口 6.0 2012-09-26 修改版本号,修改手机直充可选面值 6.1 2013-03-26 修改接口使用顺序、增加文档说明 出现错误码时只返回错误码和错误描述 说明 本文档供SP和本项目的后续开发维护人员使用,为了业务系统的安全,请严格不泄露本协议接口. 在这个接口协议中,欧飞OFCARD作为内容供应商,我们称之为CP,调用我们接口的商户作为一个业务点,我们称之为SP. 通过接口SP能够根据需要从CP实时获得需要的商品信息,可以提取卡密或者对帐号进行实时充值. 本接口的业务逻辑基于欧飞API供货大接口(http://api.ofpay.com/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 账户剩余金额 调用的链接如下: http://api2.ofpay.com/queryuserinfo.do?userid=Axxxxx&

userpws=xxxxxxx&

version=6.0 返回的XML: ?? - ? ?

1 ? 352328.97 ? AXXXXX ? 2查询所有商品大类(querybigcard.do) 此接口用于查询所有商品的大类信息 调用的链接如下: http://api2.ofpay.com/querybigcard.do 返回的内容: