完美页游联运接入文档V1-5.docVIP

完美页游联运接入文档 修订记录 日期 修订版本 修改章节 修改描述 作者 2013-02-28 1.0 创建 linhao 2013-03-08 1.1 修复角色查询接口签名描述错误 linhao 2013-04-03 1.2 添加调试信息 Pangxin 2013-04-09 1.3 添加域名解析CNAME相关信息 pangxin 2013-04-24 1.4 添加测试相关url pangxin 2013-05-10 1.5 修改域名解析CANME相关信息 pangxin 目录 目录 2 1. 前言 3 2. 登陆 3 2.1. 登陆接口 3 2.1.1. 游戏URL形式 3 2.1.2. 接口说明 3 3. 游戏充值划拨接口 4 3.1. 游戏充值划拨接口 4 3.1.1. 接口URL形式 4 3.1.2. 接口说明 5 4. 查询游戏角色信息接口 6 4.1. 查询游戏角色信息接口 7 4.1.1. 接口URL形式 7 4.1.2. 接口说明 7 5. 调试帮助 8 6. 域名解析（CNAME）规则 9 7. 完美页游正式服务器URL 9 7.1. 登陆URL 9 7.2. 划拨URL 10 7.3. 角色查询 10 8. 完美页游测试服务器URL 10 8.1. 测试登陆URL 10 8.2. 测试划拨URL 10 8.3. 测试角色查询 10 前言 本文档共有三个个接口的描述分别为登陆接口和充值划拨接口、角色查询接口，其中登陆接口采用浏览器重新定向的方式传递参数，采用MD5签名保证安全，充值划拨和角色查询接口使用MD5数据签名和IP地址白名单方式保证安全。 登陆 游戏的登陆通过平台浏览器重新定向的方式向游戏传递认证参数的方式，和平台商定一个“签名密码”，安全性由这个密码来保证。具体方式是，平台使用签名密码对用户的ID、时间戳及防沉迷状态进行签名，游戏收到信息后对签名进行校验，如果校验成功后会使用服务器的时间和传递过来的时间戳进行比对，如果在有效期内则成功进入游戏。； 注：由于签名的时效和双方的服务器时间有关，请保证服务器时间为正确的北京时间 登陆接口 游戏URL形式 登录URL：/login 测试登录URL：30:9090/login 游戏的URL和游戏相关，不同的游戏有不同的URL，以战三国为例： /login?from=173game=zsgserver=1user_idatigue=0tignature=25d55ad283aa400af464c76d713c07ad 在URL中“?”之前的是游戏的URL，“?”之后是参数 测试请使用文档后的测试登录URL 接口说明 参数列表 参数名 必选 类型及范围 说明 from 是 string 用户来源，标示用户的来源，由完美提供 game 是 string 要登陆的游戏，由完美提供，例如：zsg：战三国 server 是 string 服务器编号（1,2），由完美提供 user_id 是 string 用户账户ID fatigue 是 int 防沉迷（0为未填写信息，1为防沉迷账号，2为非防沉迷账号） servername 否 string 页面title显示服务器名称，中文需要URLEncoding UTF-8编码，不传入默认使用以下名称： 《战三国》- 双线X服 t 是 long 时间戳（秒） signature 是 string 验证串（生成验证串时使用from、game、server、userid、fatigue、t这个六个参数），md5值的小写字符串 生成方法见下方 _debug 否 int 调试参数，不计入签名，不可用于正式环境，值为1时，可以返回更详细的错误信息 参数signature的生成方法 将参数名和参数值拼成如下形式： from=173+game=zsg+server=1+user_idfatigue=0+t login_secret_signature=xxxxxxxx，计算该值的32位md5的值 说明： 在“=”（等号，半角字符）之前是参数名称，之后是该参数的值。 其中“+”（加号）为字符串的连接运算符，不包含在签名串内，请根据不同的计算机语言进行替换 login_secret_signature为双方商定的游戏登陆“签名秘钥”，该密钥很重要不得泄露。（注意：该秘钥和充值用的不是同一个） 测试时签名秘钥使用:123456 游戏充值划拨接口 充值划拨接口采用http协议，get提交数据方式，结果以json格式返回。 该接口有防火墙的IP限制，开通之前需要将平台调用该接口服务器的IP通知完美。 游戏充值划拨