百度游戏联运平台--接口说明((网页游戏)
返回代码 ERROR_-1 ERROR_-100 ERROR_-200 ERROR_-500 ERROR_-1406 ERROR_-1814 ERROR_-11000 描述信息 系统内部错误 传入参数不符合规则 系统错误 数据库操作失误 账号不存在 超过方法最大调用次数 非法IP访问 2.3 实时post角色信息接口
合作商户->百度
2.3.1 功能描述
合作商户在玩家建立角色和删除角色时,向百度的服务器通过POST发送该用户在对应服务器的角色信息。
2.3.2 接口参数
接口形式:
http://youxi.http://www.china-audit.com//game_role_rest?api_key=123123&user_id=xxxxx&server_id=220×tamp=xxxxxxxxxxxxx&role_name=xxxxxxxxx&action=xxxxxxxxxx&sign=xxxxxxxxxxxx 其中
百度提供的实时推送角色的URL为
http://youxi.http://www.china-audit.com//game_role_rest
字段名称 api_key user_id server_id timestamp role_name 9
必填 是 是 是 是 是 说明 api_key为百度游戏开放平台分配给合作商户游戏的唯一编号。 用户的百度用户编号id 百度游戏开放平台分配给合作商户游戏的服务器编号 服务请求时间戳,格式yyyy-MM-dd hh:mm:ss 用户角色名角色名(需要URLEncode以UTF-8进行编码) 百度游戏联运平台--接口说明((网页游戏)
action sign 是 是 CREATE:创建角色 DELETE:删除角色 签名认证 注意:只支持POST方式
调用方法,参照newJavaDemo中的PostRoleServlet和InputRoleInfo.jsp
请求返回值:recive ok
2.4 每日新建角色记录文件
百度->合作商户
2.4.1 功能描述
厂商将各服务器当天创建的角色以 serverId userId roleName createTime
lastLoginTime 格式(空格作为分隔符)保存在txt文件中(文件名就是“游戏名的拼音首字母_日期”)。并开放存储该文件的服务器路径的ftp/wget权限,以便百度服务器第二天6点以后到厂商服务器抓取该txt文件。例如ddt_2010-05-19.txt存储2010-05-19产生的所有角色信息,厂商需要在5 月20日上午6点前保证这个文件存在。 厂商提供: 1. 2.
每日定时生成文本文件(文件名就是日期_游戏名的拼音首字母) 分配创建ftp/wget的用户
3. 文件每行的数据以空格分隔
【文件格式】
serverId userId roleName createTime lastLoginTime serverId userId roleName createTime lastLoginTime serverId userId roleName createTime lastLoginTime
其中,serverId是用户创建角色服务器编号,userId是用户的在百度游戏的唯一ID,roleName是用户创建的角色名,createTime是用户创建角色的时间,lastLoginTime是用户最近登录游戏的时间。
【弹弹堂举例】
文件名:ddt_2010-05-17.txt (5月18日,获取5月17日的数据) 文件内容:
220 12709 火流星 2010-5-17 19:20:33 2010-5-17 19:21:33 220 12710 火流星2 2010-5-17 19:22:33 2010-5-17 19:23:33 220 12711 火流星3 2010-5-17 19:36:33 2010-5-17 19:37:33
10
百度游戏联运平台--接口说明((网页游戏)
2.5 充值接口,即付款结果通知合作商户
百度->合作商户
2.5.1 功能描述
百度游戏平台收到第三方支付成功后,向合作商户Mall发送付款结果通知,并等待接收Mall发货结果的响应信息。
合作商户需按照接口规范开发 支付通知接收接口,以供百度游戏平台调用。 付款通知分为“前台WEB转向通知”和“后台通知”,付款完成后两种通知都会被发出。不同在于前台WEB转向通知会在付款完成后随即发出,后台通知会定时发送。
2.5.2 合作商户接收支付通知接口参数
接口形式:
http://mall.com/somepath?api_key=a001&user_id=110&server_id=s1&order_id=1234567890&wanba_oid=567567567&amount=100¤cy=CNY&result=1&back_send=N×tamp=2010-04-22 12:12:12&sign=WEWET8FDDAFAFGFGHDFH
请求参数: 字段名称 api_key user_id server_id order_id wanba_oid amount currency result 必填 是 是 是 是 是 是 是 是 说明 百度游戏开放平台分配给合作商户游戏的唯一编号 百度游戏平台对应玩家ID 游戏厂商平台对应服务器ID 百度游戏平台对应玩家订单号 百度游戏平台对应订单号 金额(单位元) 币种 支付结果,支付成功返回“1”,支付中返回“0”,支付失败返回“-1” 后台通知(Y)、前台通知(N) 时间戳 签名认证 back_send timestamp sign 11
是 是 是 百度游戏联运平台--接口说明((网页游戏)
请求返回值:
或其它信息 1. 订单验证签名成功,只要加游戏币成功或曾经加游戏币成功,每次都返回。 2. 接收到非 的信息,百度会连续三天继续发送支付结果通知。 【通知方式】
1.前台WEB转向通知
通过用户浏览器转向到游戏厂商对应的支付通知回调地址。back_send=N ,此时可以不做响应,只负责添加游戏币 2.后台通知
a) 百度游戏平台会进行后台通知;(每一笔订单都会发送,是前台通知的补单程序) b) 参数定义:当back_send=Y时,表明服务器端是进行的后台通知。如果百度游戏平
台未收到商户发回的 会在连续三天内一直发送后台通知
【前台Web转向通知示例】
http://mall.com/somepath?api_key=a001&user_id=110&server_id=s1&order_id=1234567890&wanba_oid=567567567&amount=100¤cy=CNY&result=1&back_send=N×tamp=2010-04-22 12:12:12&sign=WEWET8FDDAFAFGFGHDFH
【后台通知示例】
http://mall.com/somepath?api_key=a001&user_id=110&server_id=s1&order_id=1234567890&wanba_oid=567567567&amount=100¤cy=CNY&result=1&back_send=Y×tamp=2010-04-22 12:12:12&sign=WEWET8FDDAFAFGFGHDFH
2.5.3 支付通知响应
Mall处理支付通知请求,给用户发货后,将发货结果返回给百度游戏平台。
商户需要返回指定字符串,并保证取货操作只完成一次。
2.6 商户查询接口(Mall?GOP)
不是上线必需开发的接口,可以在二期完成
12
相关推荐: