百度游戏联运平台
游戏接入接口说明(客户端游戏)
版本：V1.3
欢迎加入百度游戏联运平台，本文档描述了百度游戏平台（本文以下简称之为“平台”）与合作方商户游戏（本文以下简称之为“合作方商户”）之间的通信接口标准，供合作方开发人员参看。
请合作厂商技术人员查看本文档后，及时反馈开发进度表（包含研发、连调与上线内测），以便我们安排人员技术支持与提前准备上线推广等事宜。
百度游戏– 游戏运营 –产品技术文档
youxi.baidu
---------------------------------------------------------------------------------------------------------------------
修订历史记录
日期 | 版本 | 说明 | 作者 |
目录
1 开发要点综述 3
1.1 开发流程简要 3
1.1.1 开发过程指导 3
1.1.2 百度与合作方交互说明 3
1.1.3 开发检查指南(客户端) 4
1.1.4 算法实现 5
1.1.5 编码问题 6
2 客户端游戏 7
2.1 服务器认证 7
2.1.1 服务端得到的参数 7
2.1.2 服务端发起玩家登录认证 8
2.1.3 返回结果 8
2.2 实时查询角 9
2.2.1 返回结果 10
2.3 实时post角信息接口 10
2.3.1 功能描述 11
2.3.2 接口参数 11
2.4 每日新建角记录文件 11
2.4.1 功能描述 12
2.5 充值接口，即付款结果通知合作商户(客户端游戏) 12
2.5.1 功能描述 12
2.5.2 合作商户接收支付通知接口参数 13
2.5.3 支付通知响应 14
2.6 商户查询接口（MallGOP） 14
2.6.1 功能描述 14
2.6.2 单笔交易查询接口 14
2.6.3 按时间段查询接口 16
2.6.4 按时间段总账查询接口 18
2.7 根据userName查询userId单个查询接口 20
2.7.1 功能描述 20
2.7.2 接口参数 20
1 开发要点综述
开发流程简要
1.1.1 百度与合作方交互说明
事项 | 素材提供方 | 实施方 | 实施细节 | 备注 |
游戏厂商 | 百度 | URL地址由百度提供 | ||
充值 | 百度 | 厂商和百度 | 1.百度在自己的URL地址上实现选择服务器和提交订单 2.支付成功通知厂商发货 3.后台通知确保用户在前台通知失败的情况下，3天内仍然有机会补上游戏币 | |
登录进入游戏（选服页) | 百度 | 厂商和百度 | 登录页引导到百度，登录成功后通知客户端 | |
查询角 | 厂商和百度 | 百度->厂商 根据UID查询角信息 | 充值时 | |
实时post角 | 厂商和百度 | 厂商->百度 用户创建角时通知百度 | ||
每日角文件 | 厂商和百度 | 定时生成角数据提供百度下载 | ||
帐户体系 | 百度 | 厂商 | 使用百度的用户名登录 | 传给厂商的是用户ID |
防沉迷 | 用户输入 | 厂商和百度 | 百度与厂商需要交互数据，让用户补全信息 | 百度通过登录接口传入防沉迷标志位。y:需要防沉，n：不需要防沉迷，不做控制 |
1.1.2 开发检查指南(客户端)
1． 合作方需要提供的资料说明
提供数据 | 说明 |
用户认证 | 合作方提供的进入游戏和充值，只提供百度的已登录用户，不允许用户未登录直接进入游戏或充值。 |
游戏客户端 | 合作方提供游戏客户端，需要保证此客户端提供给百度的用户，使用百度的用户名登录 |
服务器编码 | 百度在用户登录时传递server_id，具体的值由厂商提供。 |
各游戏服角查询接口地址 | 合作商户提供给百度查询用户是否激活过游戏或创建过角的接口地址。各个游戏页服可以不同，开新服前必须提供。 |
是否需要创建角充值 | 根据这个标志位，在充值前判断是否需要调用角查询接口。是，调用角查询接口；否,不调用 |
游戏币名称 | 举例：金币,元宝 |
游戏币与人民币的兑换比例 | 1人民币:xx金币，用于页面显示，百度实际结算的是人民币 |
统一登录接口地址 | 合作商户统一的进入游戏服务器的接口地址，保证未登录用户，直接返回到百度选服页。直接收藏保存地址为youxi.baidu。 |
各游戏页充值接口通知地址 | 百度通知合作商户的充值成功的接口地址。各个游戏页服可以不同，开新服时必须提供。 |
客服后台 | 合作方需要提供给百度后台系统，能够根据百度的用户名和订单号查询到交易信息 |
实时监控 | 合作方需要对进入游戏页和充值结果通知页的正常显示增加监控，确保服务的正常运行。 |
2． 双方验证资料
提供数据 | 说明 |
官网地址 | 百度提供本游戏的首页地址，当游戏页面的程序出错时会跳转到这个地址。 例如 youxi.baidu/xxx/index/ xxx为游戏的首字母 |
论坛地址 | 百度提供官方贴吧，游戏合作方负责在游戏中相关页面展现。玩家将通过此地址可以直接从游戏中跳转到游戏论坛 |
进入游戏地址 | 百度提供进入游戏的地址，游戏合作方需要保证正确进入指定的游戏服务器。 |
充值地址 | 百度提供充值的地址，游戏合作方需要保证游戏中链接的充值地址正确。 |
充值结果 | 百度通知支付结果，游戏合作方保证正确添加游戏币 |
注册地址 | 客户端中的注册地址链接到百度提供的用户注册地址 |
客户端交互 | 百度将用户登录结果及时传递给客户端，客户端能接收百度传回的登录信息，并做出相应的响应 |
公告页地址 | 百度提供公告页的地址，游戏合作方负责在游戏中相关页面展现。 |
客服 | 百度提供客服，游戏合作方负责在游戏中相关页面展现。 |
1.1.3 算法实现
为了保证游戏商户和百度游戏服务器之间通信的安全，避免出现api_key被盗用的情况，平台采用签名认证机制。由于app_secret密钥只有平台和应用双方知道，唯一而且不公开，所以将当前请求和商户游戏分配的app_secret进行MD5 HASH生成sign。
1.1.3.1 签名算法生成规则
• 将请求中所有参数进行排序，排序为字典顺序，去除 & 符号；
• 在上述转换后的串前面加上游戏的app_secret；
• 用MD5算出上述串的标准32位MD5值，得到sign的值，全部转成大写字母。
1.1.3.2 签名算法详细示例
第一步：在未加入签名认证之前百度游戏服务器向合作商户登录游戏服务器POST/GET下面的请求详细信息为：
user_id=672134&api_key=27dccf180127259d89d81737e0736700&server_id=220&cm_flag=y ×tamp=2010-04-26 11:09:52
第二步：经过第一步字典排序后，request的参数串就变为：
api_key=27dccf180127259d89d81737e0736700cm_flag=yserver_id=220timestamp=2010-04-26 11:09:52user_id=672134
服务器第三步：示例中的游戏app_secret为9bc193eb243824610124382461e60002，则经过第二步放参数的第一位，去掉参数间的等号以及除时间戳内日期和小时之间以外的全部空格，示例中request的参数串变为：
9bc193eb243824610124382461e60002api_key27dccf180127259d89d81737e0736700cm_flagyserver_id220timestamp2010-04-26 11:09:52user_id672134
第四步：经过第三步MD5计算后，示例中生成的MD5值为：54d458365f74a3396917ed9f3fd
8336d，则应用向百度游戏服务器最终POST请求的参数为：
api_key=27dccf180127259d89d81737e0736700&cm_flag=y&server_id=220×tamp=2010-04-26 11:09:52&user_id=672134&sign=54d458365f74a3396917ed9f3fd8336d
sign最后统一为大写：
api_key=27dccf180127259d89d81737e0736700&cm_flag=y&server_id=220×tamp=2010-04-2611:09:52&user_id=672134&sign=54D458365F74A3396917ED9F3FD8336D
1.1.4 编码问题
百度游戏平台采用的UTF-8编码，涉及到中文时需要使用URLEncode编码。
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论