游戏接入接口说明(网页游戏)

admin管理员组

文章数量:1531791

2023年12月25日发(作者：)

百度游戏联运平台

游戏接入接口说明(网页游戏)

版本：V1.3

欢迎加入百度游戏联运平台，本文档描述了百度游戏平台（本文以下简称之为“平台”）与合作方商户游戏（本文以下简称之为“合作方商户”）之间的通信接口标准，供合作方开发人员参看。

请合作厂商技术人员查看本文档后，及时反馈开发进度表（包含研发、连调与上线内测），以便我们安排人员技术支持与提前准备上线推广等事宜。

百度游戏– 游戏运营 –产品技术文档

---------------------------------------------------------------------------------------------------------------------

修订历史记录

日期

2010.4.12

2010.4.14

2010.4.26

2010-5-16

版本

1.1

1.2

1.3

1.3

说明

整理文档

调整文档结构，新增指南ppt

游戏接入新接口:充值页和选服页在百度实现

作者

许红艳

许红艳

许红艳

新增实时post角色，定时获取角色

接口

百度游戏联运平台--接口说明((网页游戏)

目录

1 开发要点综述 ................................................................................................................ 3

1.1 开发流程简要....................................................................................................... 3

1.1.1 开发过程指导 ................................................................... 错误！未定义书签。

1.1.2 百度与合作方交互说明 ................................................................................... 3

1.1.3 开发检查指南 ................................................................................................. 3

1.2 特殊说明.............................................................................................................. 5

1.2.1 访问方式 ........................................................................................................ 5

1.2.2 算法实现 ........................................................................................................ 5

1.2.3 编码问题 ........................................................................................................ 6

2 接口详细说明 ................................................................................................................ 7

2.1 登录接口.............................................................................................................. 7

2.1.1 功能描述 ........................................................................................................ 7

2.1.2 接口参数 ........................................................................................................ 7

2.2 实时查询角色....................................................................................................... 8

2.2.1

2.2.2

2.2.3

功能描述 ........................................................................................................ 8

接口参数 ........................................................................................................ 8

返回结果 ........................................................................................................ 8

2.3 实时post角色信息接口 ........................................................................................ 9

2.3.1 功能描述 ........................................................................................................ 9

2.3.2 接口参数 ........................................................................................................ 9

2.4 每日新建角色记录文件....................................................................................... 10

2.4.1 功能描述 ...................................................................................................... 10

2.5 充值接口，即付款结果通知合作商户...................................................................11

2.5.1 功能描述 .......................................................................................................11

2.5.2 合作商户接收支付通知接口参数 ....................................................................11

2.5.3 支付通知响应 ............................................................................................... 12

2.6 商户查询接口（MallGOP）............................................................................. 12

2.6.1 功能描述 ...................................................................................................... 13

2.6.2 单笔交易查询接口 ........................................................................................ 13

2.6.3 按时间段查询接口 ........................................................................................ 14

2.6.4 按时间段总账查询接口 ................................................................................. 16

2.7 根据userName查询userId单个查询接口 ............................................................ 18

2.7.1

2.7.1

功能描述 ...................................................................................................... 18

接口参数 ...................................................................................................... 18

20

2

百度游戏联运平台--接口说明((网页游戏)

1 开发要点综述

1.1 开发流程简要

1.1.1 百度与合作方交互说明

事项

官网

素材提供方 实施方

游戏厂商 百度

实施细节

URL地址由百度提供

1.百度在自己的URL地址上实现选择服充值 百度

务器和提交订单

厂商和百度 2.支付成功通知厂商发货

3.后台通知确保用户在前台通知失败的情况下，3天内仍然有机会补上游戏币

厂商和百度

百度提供选服页地址，接口验证通过直接进入游戏

百度在后台设置相应是否内嵌，厂商需要保证内嵌后的页面正常

百度

百度根据用户的登录记录在选服页上显示

直接访问游戏页面地址不允许

默认是需要内嵌

充值时

传给厂商的是用户ID

百度通过登录接口传防沉迷 用户输入 厂商和百度

百度与厂商需要交互数据，让用户补全信息

入防沉迷标志位。y:需要防沉，n：不需要防沉迷，不做控制

备注

登录进入游戏（选服页)

是否内嵌

注册进新服

最近登录的服务器

查询角色

实时post角色

每日角色文件

帐户体系

百度

无

无

游戏厂商

百度

厂商和百度

百度

百度

厂商和百度 百度->厂商 根据UID查询角色信息

厂商和百度 厂商->百度 用户创建角色时通知百度

厂商和百度 定时生成角色数据提供百度下载

厂商 使用百度的用户名登录

1.1.2 开发检查指南

1． 合作方需要提供的资料说明

3

百度游戏联运平台--接口说明((网页游戏)

提供数据

用户认证

说明

合作方提供的进入游戏和充值，只提供百度的已登录用户，不允许用户未登录直接进入游戏或充值。

游戏服务器的域名,例如一服(bd01.游戏名简写.),二服(bd02.游戏名简写.…)

用户退出游戏时的收藏地址统一为；用户收藏选服页或游戏服务器页的地址一为。如果无法更改收藏属性也需要判断，如果用户直接访问合作方的游戏服务器地址需要跳转到

百度在用户登录时传递server_id，具体的值由厂商提供。

合作商户提供给百度查询用户是否激活过游戏或创建过角色的接口地址。各个游戏页服可以不同，开新服前必须提供。

根据这个标志位，在充值前判断是否需要调用角色查询接口。是，调用角色查询接口；否,不调用

举例：金币,元宝

1人民币:xx金币，用于页面显示，百度实际结算的是人民币

合作商户统一的进入游戏服务器的接口地址，保证未登录用户，直接返回到百度选服页。直接收藏保存地址为。

百度通知合作商户的充值成功的接口地址。各个游戏页服可以不同，开新服时必须提供。

合作方需要提供给百度后台系统，能够根据百度的用户名和订单号查询到交易信息

合作方需要对进入游戏页和充值结果通知页的正常显示增加监控，确保服务的正常运行。

游戏域名

收藏夹地址

服务器编码

各游戏服角色查询接口地址

是否需要创建角色充值

游戏币名称

游戏币与人民币的兑换比例

统一登录接口地址

各游戏页充值接口通知地址

客服后台

实时监控

2． 双方验证资料

提供数据

官网地址

说明

百度提供本游戏的首页地址，当游戏页面的程序出错时会跳转到这个官网地址。

例如 /xxx/index/

xxx为游戏的首字母

百度提供官方贴吧，游戏合作方负责在游戏中相关页面展现。玩家将通过此地址可以直接从游戏中跳转到游戏论坛

百度提供进入游戏的地址，游戏合作方需要保证正确进入指定的游戏服务器。

百度提供充值的地址，游戏合作方需要保证游戏中链接的充值地址正确。

百度通知支付结果，游戏合作方保证正确添加游戏币

百度提交用户信息，合作方商户返回用户角色信息。

论坛地址

进入游戏地址

充值地址

充值结果

查询角色

4

百度游戏联运平台--接口说明((网页游戏)

防沉迷补全资料URL

公告页地址

客服联系方式

游戏中要求实现防沉迷，百度负责在用户登录时传入防沉迷标志位。当游戏厂商强制用户退出游戏或提示处于防沉迷状态时，提醒用户补全个人信息/my_?gid =xxx

百度提供公告页的地址，游戏合作方负责在游戏中相关页面展现。

百度提供客服联系方式，游戏合作方负责在游戏中相关页面展现。

1.1.3 服务器稳定必备

1.1.3.1 状态文件

文件名:

文件内容：

放置位置：登录服务器,域名所在的相关目录

1.1.3.2 登录游戏域名

游戏名称 登录游戏域名

分区状态文件

接口服务器IP地址 到期时间 登录接口状态文件url1.2 特殊说明

1.2.1

访问方式

本文档描述接口的请求方式均为HTTP的POST方式

1.2.2 算法实现

为了保证游戏商户和百度游戏服务器之间通信的安全，避免出现api_key被盗用的情况，平台采用签名认证机制。由于app_secret密钥只有平台和应用双方知道，唯一而且不公开，所以将当前请求和商户游戏分配的app_secret进行MD5 HASH生成sign。

5

百度游戏联运平台--接口说明((网页游戏)

1.2.2.1 签名算法生成规则

•

•

•

将请求中所有参数进行排序，排序为字典顺序，去除 & 符号；

在上述转换后的串前面加上游戏的app_secret；

用MD5算出上述串的标准32位MD5值，得到sign的值，全部转成大写字母。

1.2.2.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为9bc193eb24382461e60002，则经过第二步放参数的第一位，去掉参数间的等号以及除时间戳内日期和小时之间以外的全部空格，示例中request的参数串变为：

9bc193eb24382461e60002api_key27dccf180127259d89d81737e0736700cm_flagyserver_id220timestamp2010-04-26 11:09:52user_id672134

第四步：经过第三步MD5计算后，示例中生成的MD5值为：54d458365f74a3396917ed9f3fd8336d，则应用向百度游戏服务器最终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.2.3 编码问题

6

百度游戏平台采用的UTF-8编码，涉及到中文时需要使用URLEncode编码。

【举例】：百度游戏

百度游戏联运平台--接口说明((网页游戏)

URLEncode以后的值= %E7%99%BE%E5%BA%A6%E6%B8%B8%E6%88%8F

2 接口详细说明

百度游戏联合运营商户需要完成以下接口，实现用户进入游戏页和接收支付通知。

2.1 登录接口

百度->合作商户

2.1.1 功能描述

百度传入百度游戏平台的账号信息，厂商实现用户登录游戏的功能，使用post方法。

2.1.2 接口参数(带防沉迷标志位)

接口形式：

/somepath?

api_key=a001&user_id=110&server_id=s1&cm_flag=y×tamp=2010-04-22 12:12:12&sign=

WEWET8FDDAFAFGFGHDFH

请求参数：

字段名称

api_key

user_id

server_id

cm_flag

timestamp

sign

请求返回值：无

必填

是

是

是

是

是

是

说明

api_key为百度游戏开放平台分配给合作商户游戏的唯一编号。

用户的百度用户编号id

百度游戏开放平台分配给合作商户游戏的服务器编号

防沉迷标示，y: n:,y表示被防沉迷，n表示不需要被防沉迷

服务请求时间戳，格式yyyy-MM-dd hh:mm:ss

签名认证

验证成功：直接转向到server_id约定的游戏服务器页面(需要支持在百度框架内正常显示)

验证失败：提示用户，返回到(需要支持在百度框架内正常显示)

7

百度游戏联运平台--接口说明((网页游戏)

2.2 实时查询角色

百度->合作商户

2.2.1 功能描述

百度传入百度游戏平台的账号信息，合作商户返回该用户在对应服务器的角色信息。

2.2.2 接口参数

接口形式：

/somepath?api_key=a001&user_id=110&server_id=s1×tamp=2010-04-22

12:12:12&sign= WEWET8FDDAFAFGFGHDFH

请求参数：

字段名称

api_key

user_id

server_id

timestamp

sign

必填

是

是

是

是

是

说明

api_key为百度游戏开放平台分配给合作商户游戏的唯一编号。

用户的百度用户编号id

百度游戏开放平台分配给合作商户游戏的服务器编号

服务请求时间戳，格式yyyy-MM-dd hh:mm:ss

签名认证

2.2.3 返回结果

直接RESPONSE返回结果。如果返回的是以ERROR_开头的字符串，则表示调用错误，否则返回以下格式的字符串：

role_name

例如：

火流星1

火流星2

火流星3

如果返回多条记录，每条记录之间用n分隔，如果没有记录则返回空字符串。数据库中位null的值以空字符串返回。返回结果按照role_name升序进行排列。

参数名称

role_name

类型

String

说明

角色名（url重写，编码是utf-8）

以下是返回的错误码：

8

百度游戏联运平台--接口说明((网页游戏)

返回代码

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 接口参数

接口形式：

/game_role_rest?api_key=123123&user_id=xxxxx&server_id=220×tamp=xxxxxxxxxxxxx&role_name=xxxxxxxxx&action=xxxxxxxxxx&sign=xxxxxxxxxxxx

其中

百度提供的实时推送角色的URL为

/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和

请求返回值：recive ok

2.4 每日新建角色记录文件

百度->合作商户

2.4.1 功能描述

厂商将各服务器当天创建的角色以 serverId userId roleName createTime

lastLoginTime 格式（空格作为分隔符）保存在txt文件中（文件名就是“游戏名的拼音首字母_日期”）。并开放存储该文件的服务器路径的ftp/wget权限，以便百度服务器第二天6点以后到厂商服务器抓取该txt文件。例如ddt_存储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_ (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 合作商户接收支付通知接口参数

接口形式：

/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． 接收到非 的信息，百度会连续三天继续发送支付结果通知。

【通知方式】

１．前台WEB转向通知

通过用户浏览器转向到游戏厂商对应的支付通知回调地址。back_send=N ，此时可以不做响应，只负责添加游戏币

２．后台通知

a) 百度游戏平台会进行后台通知；（每一笔订单都会发送，是前台通知的补单程序）

b) 参数定义：当back_send=Y时，表明服务器端是进行的后台通知。如果百度游戏平台未收到商户发回的 会在连续三天内一直发送后台通知

【前台Web转向通知示例】

/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

【后台通知示例】

/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

百度游戏联运平台--接口说明((网页游戏)

2.6.1 功能描述

商户发送订单查询请求到百度游戏平台，并接收查询结果响应信息。

2.6.2 单笔交易查询接口

接口形式：/rest?api_key=xxxx&api_name=der×tamp=2009-03-11

20:00:00&format=xml&v=1.0&order_id=111111&sign=23ED99F1A0A1EAC5F3787D522AFDE1C4

请求参数：

字段名称

api_key

api_name

format

order_id

timestamp

v

sign

请求返回值：

必填

是

是

是

是

是

是

是

说明

百度游戏开放平台分配给合作商户游戏的唯一编号

服务名（订单明细查询接口对应 der 方法）

需要Response的格式，XML、JSON。

商户订单号

服务请求时间戳，格式yyyy-MM-dd hh:mm:ss

接口版本号（目前是1.0）

签名认证，用于验证签名结果，不参加签名

返回值

result

amount

order_time

return_attach

wanba_oid

gameName

order_id

【调用范例】

描述

订单状态，30表示支付成功

订单金额,单元：元

订单时间，格式：年月日时分秒XXXX-XX-XX xx:xx:xx

订单备注

游戏平台的订单号

游戏名称，允许中文，UTF-8字符集

支付订单号

/rest?api_key=a001&api_name=der×tamp=2009-03-11

13

百度游戏联运平台--接口说明((网页游戏)

20:00:00&format=xml&v=1.0&order_id=111111&sign=23ED99F1A0A1EAC5F3787D522AFDE1C4

【返回结果】

XML：

10.0

30

2010-04-01 12:19:25

返回描述

测试游戏1

test_127

BaiduCoin.

JSON：

{"conut":1,"orders":[{"amount":10,"result":"30","order_time":"2010-04-01 12:19:25","return_attach":"返回描述","wanba_oid":"","gameName":"测试游戏1","order_id":"test_127","pay_name":"BaiduCoin."}]}

【错误返回信息】

106

订单号不存在

2.6.3 按时间段查询接口

接口形式：/rest?api_key=a001&api_name=derByTime×tamp=2009-03-11 20:00:00&format=xml&v=1.0&sdatetime=2009-03-11 20:00:00&edatetime=2009-03-11

20:00:00&sign=23ED99F1A0A1EAC5F3787D522AFDE1C4

请求参数:

14

百度游戏联运平台--接口说明((网页游戏)

字段名称

api_key

api_name

format

sdatetime

edatetime

timestamp

v

sign

请求返回值:

必填

是

是

是

是

是

是

是

是

说明

百度游戏开放平台分配给合作商户游戏的唯一编号

服务名（订单明细查询接口对应 derByTime 方法）

Response的格式，XML、JSON

查询订单开始时间，精确到秒

结束时间，精确到秒

服务请求时间戳，格式yyyy-MM-dd hh:mm:ss

接口版本号（目前是1.0）

签名认证，用于验证签名结果，不参加签名

返回值

result

orderNum

money

sdatetime

edatetime

【调用范例】

描述

订单状态，30表示支付成功

订单笔数

订单金额，人民币，单位：元

返回查询时输入的开如时间

返回查询时输入的结束时间

/rest?api_key=a001&api_name=derByTime×tamp=2009-03-11 20:00:00&format=xml&v=1.0&sdatetime=2009-03-11 20:00:00&edatetime=2009-03-11

20:00:00&sign=23ED99F1A0A1EAC5F3787D522AFDE1C4

【返回结果】

XML：

无数据：

有数据：

15

百度游戏联运平台--接口说明((网页游戏)

10.0

30

2010-04-01 12:19:25

返回描述

测试游戏1

test_127

CNY

100.0

30

2010-04-01 12:20:39

返回描述

1269833ljf

测试游戏1

test_127

CNY

JSON：{"conut":2,"orders":[{"amount":10,"result":"30","order_time":"2010-04-01 12:19:25","return_attach":"返回描述","wanba_oid":"","gameName":"测试游戏1","order_id":"test_127","currency":"CNY"},{"amount":100,"result":"30","order_time":"2010-04-01 12:20:39","return_attach":"返回描述","wanba_oid":"1269833ljf","gameName":"测试游戏1","order_id":"test_127","currency":"CNY"}]}

2.6.4 按时间段总账查询接口

接口形式：

/rest?api_key=a001&api_name=wanba. findAccountsByTime

×tamp=2009-03-11 20:00:00&format=xml&v=1.0&sdatetime=2009-03-11

20:00:00&edatetime=2009-03-11 20:00:00&sign=23ED99F1A0A1EAC5F3787D522AFDE1C4

请求参数:

16

百度游戏联运平台--接口说明((网页游戏)

字段名称

api_key

api_name

必填

是

是

说明

百度游戏开放平台分配给合作商户游戏的唯一编号

服务名（总账查询接口对应 countsByTime 方法）

Response的格式，XML、JSON

查询订单开始时间，精确到秒

结束时间，精确到秒

服务请求时间戳，格式yyyy-MM-dd hh:mm:ss

接口版本号（目前是1.0）

签名认证，用于验证签名结果，不参加签名

format

sdatetime

edatetime

timestamp

v

sign

请求返回值:

是

是

是

是

是

是

返回值

orderNum

money

sdatetime

edatetime

描述

订单笔数

订单金额，人民币，单位：元

返回查询时输入的开如时间

返回查询时输入的结束时间

error_response

Xml格式，未查询返回

response

Xml格式，正常查询返回

【调用范例POST】

/rest?api_key=a001&api_name=wanba. findAccountsByTime

×tamp=2009-03-11 20:00:00&format=xml&v=1.0&sdatetime=2009-03-11

20:00:00&edatetime=2009-03-11 20:00:00&sign=23ED99F1A0A1EAC5F3787D522AFDE1C4

【返回结果】

XML：

10.0

1

17

百度游戏联运平台--接口说明((网页游戏)

JSON：

{"conut":1,"orders":[{"money":10,"orderNum":1}]}

无数据例子：

0

错误返回例子：

126

开始日期与结束日期间隔大于1天

2.7 根据userName查询userId单个查询接口

2.7.1 功能描述

厂商遇到百度用户投诉时可以根据用户名查询用户ID，确认在游戏中是否有充值和登录记录。

2.7.1 接口参数

目前支持POST方式，接口形式：

/rest

请求参数:

字段名称

api_key

api_name

18

必填

是

是

说明

百度游戏开放平台分配给合作商户游戏的唯一编号

服务名（根据UserName查询userId接口对应 wanba. getUserInfo

百度游戏联运平台--接口说明((网页游戏)

方法）

format

v

username

是

是

是

Response的格式，XML、JSON

接口版本号（目前是1.0）

需要查询的用户名（如果是中文，在加入签名之前必须UrlEncode以UTF-8方式进行转码）

查询的域，指定为id

服务请求时间戳，格式yyyy-MM-dd hh:mm:ss

签名认证

fields

timestamp

sign

请求返回值:

是

是

是

返回值

result

id

描述

返回的信息码。根据返回代码判断是否需要继续获取数据

用户的user_id

以下是返回的信息码对应描述：

返回代码

102

103

104

105

113

114

121

122

【调用范例】

Form表单以POST方式提交

描述信息

调用接口不能为空

应用id不对

签名认证不对

用户不存在

服务请求时间戳为空

接口版本号为空

查询字段不能为空

查询字段不对