飞翼付系统http接口协议（V1.1）.docVIP

飞翼付系统http接口协议(V1.1) 本版本最后修订日期： 2016年01月01日 版本号 日期 说明 作者 1.0 2016-1-1 增加版本号字段，SP接入密码修改为账户密码的MD5值 MingDou 说明 本文档供SP和本项目的后续开发维护人员使用，为了业务系统的安全，请严格不泄露本协议接口。 在这个接口协议中，充（下称）作为内容供应商，我们称之为CP，调用我们接口的商户作为一个业务点，我们称之为SP。 通过接口SP能够根据需要从CP实时获得需要的商品信息，可以提取卡密或者对帐号进行实时充值。 本接口的业务逻辑基于API供货大接口（/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 固定值为：1.1(不参与MD5验证) 响应的XML标签说明 说明 err_msg 错误描述，如请求得到正确返回，此处将为空 retcode 操作返回代码，1成功,err_msg为空，其它数字具体错误在err_msg返回 ret_leftcredit 账户剩余金额 调用的链接如下： /api/queryuserinfo.do?userid=Axxxxxuserpws=xxxxxxxversion=1.1 返回的JSON： {err_msg:[],ret_leftcredit:38.12,useridretcode:1} 2手机号码归属地查询（mobinfo.do） 此接口用于查询手机号码的归属地： 请求参数： 说明 mobilenum 手机号码前七位 例：/api/mobinfo.do?mobilenum=1865070 返回：1381383|江苏南京|移动全球通卡 “111111”) (32位小写) cardnum 可选面值 移动：30、50、100 联通、电信：10、20、30、50、100、300,500） sporder_id Sp商家的订单号 sporder_time 订单时间 （yyyyMMddHHmmss 如：20070323140214） game_userid 手机号 md5_str MD5后字符串 ret_url 订单充值成功后返回的URL地址，可为空（不参与MD5验算） version 固定值为：1.1 (不参与MD5验证) md5_str检验码的计算方法: 包体=userid+userpws+cardid+cardnum+sporder_id+sporder_time+ game_userid 1: 对: “包体+KeyStr” 这个串进行md5 的32位值. 结果大写 2: KeyStr 默认为FYF, 实际上线时可以修改。 3: KeyStr 不在接口间进行传送。 加密案例: $res = md5( md5(userid.userpws.cardnum.sporder_id.sporder_time.game_userid).FYF ); $res = strtoupper( $res );