游戏接入接口说明(网页游戏)_图文.doc

百度游戏联运平台 游戏接入接口说明(网页游戏) 版本：V1.3 欢迎加入百度游戏联运平台，本文档描述了百度游戏平台（本文以下简称之为“平台”）与合作方商户游戏（本文以下简称之为“合作方商户”）之间的通信接口标准，供合作方开发人员参看。 请合作厂商技术人员查看本文档后，及时反馈开发进度表（包含研发、连调与上线内测），以便我们安排人员技术支持与提前准备上线推广等事宜。 百度游戏– 游戏运营 –产品技术文档 --------------------------------------------------------------------------------------------------------------------- 修订历史记录 日期 版本 说明 作者 2010.4.12 1.1 整理文档 许红艳 2010.4.14 1.2 调整文档结构，新增指南ppt 许红艳 2010.4.26 1.3 游戏接入新接口:充值页和选服页在百度实现 许红艳 2010-5-16 1.3 新增实时post角色，定时获取角色接口  目录 1 开发要点综述 3 1.1 开发流程简要 3 1.1.1 开发过程指导 3 1.1.2 百度与合作方交互说明 4 1.1.3 开发检查指南 4 1.2 特殊说明 6 1.2.1 访问方式 6 1.2.2 算法实现 6 1.2.3 编码问题 7 2 接口详细说明 7 2.1 登录接口 7 2.1.1 功能描述 7 2.1.2 接口参数 7 2.2 实时查询角色 8 2.2.1 功能描述 8 2.2.2 接口参数 8 2.2.3 返回结果 9 2.3 实时post角色信息接口 9 2.3.1 功能描述 9 2.3.2 接口参数 10 2.4 每日新建角色记录文件 10 2.4.1 功能描述 10 2.5 充值接口，即付款结果通知合作商户 11 2.5.1 功能描述 11 2.5.2 合作商户接收支付通知接口参数 11 2.5.3 支付通知响应 13 2.6 商户查询接口（Mall(GOP） 13 2.6.1 功能描述 13 2.6.2 单笔交易查询接口 13 2.6.3 按时间段查询接口 15 2.6.4 按时间段总账查询接口 17 2.7 根据userName查询userId单个查询接口 19 2.7.1 功能描述 19 2.7.1 接口参数 19 3 FAQ 20  开发要点综述 开发流程简要 百度与合作方交互说明 事项 素材提供方 实施方 实施细节 备注 官网 游戏厂商 百度 URL地址由百度提供 　 充值 百度 厂商和百度 1.百度在自己的URL地址上实现选择服务器和提交订单2.支付成功通知厂商发货3.后台通知确保用户在前台通知失败的情况下，3天内仍然有机会补上游戏币 　 登录进入游戏（选服页) 百度 厂商和百度 百度提供选服页地址，接口验证通过直接进入游戏 直接访问游戏页面地址不允许 是否内嵌 无 厂商和百度 百度在后台设置相应是否内嵌，厂商需要保证内嵌后的页面正常 默认是需要内嵌 注册进新服 无 百度 百度 　 最近登录的服务器 游戏厂商 百度 百度根据用户的登录记录在选服页上显示 　 查询角色 厂商和百度 百度-厂商 根据UID查询角色信息 充值时 实时post角 每日角色文件 厂商和百度 定时生成角色数据提供百度下载 帐户体系 百度 厂商 使用百度的用户名登录 传给厂商的是用户ID 防沉迷 用户输入 厂商和百度 百度与厂商需要交互数据，让用户补全信息 百度通过登录接口传入防沉迷标志位。y:需要防沉，n：不需要防沉迷，不做控制 开发检查指南 合作方需要提供的资料说明 提供据 说明 游域名 ,例如一服(http://bd01.游戏名简写.),二服(http://bd02.游戏名简写.…) 收藏夹地址 用户退出游戏时的收藏地址统一为；用户收藏选服页或游戏服务器页的地址一为。如果无法更改收藏属性也需要判断，如果用户直接访问合作方的游戏服务器地址需要跳转到 服务器编码 百度在用户登录时传递server_id，具体的值由厂商提供。 各游戏服角色查询接口地址 合作商户提供给百度查询用户是否激活过游戏或创建过角色的接口地址。各个游戏页服可以不同， 是否需要创建角色充值 根据这个标志位，在充值前判断是否需要调用角色查询接口。是，调用角色查询接口；否,不调用 游戏币名称 举例：金币,元宝 游戏币与人民币的兑换比例 1人民币:xx金币，用于页面显示，百度实际结算的是人民币 统一登录接口地址 合作商户统一的进入游戏服务器的接口地址，保证未登录用户，直接返回到百度选服页。直接收藏保存地址为。 各游戏页充值接口通知地址