游戏联运平台

admin管理员组

文章数量:1532057

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

百度游戏联运平台--接口说明(客户端游戏)

百度游戏联运平台

游戏接入接口说明(客户端游戏)

版本：V1.3

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

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

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

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

修订历史记录

日期

版本

说明

作者

百度游戏联运平台--接口说明(客户端游戏)

目录

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

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

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

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

1.1.3 开发检查指南(客户端) ................................................................................................ 3

1.1.4 算法实现 ....................................................................................................................... 5

1.1.5 编码问题 ....................................................................................................................... 6

2 客户端游戏 .................................................................................................................................... 6

2.1 服务器认证 ......................................................................................................................... 7

2.1.1 服务端得到的参数 ..................................................................... 错误！未定义书签。

2.1.2 服务端发起玩家登录认证 ........................................................................................... 7

2.1.3 返回结果 ....................................................................................................................... 9

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

2.2.1 返回结果 ..................................................................................................................... 10

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

2.3.1 功能描述 ..................................................................................................................... 11

2.3.2 接口参数 ..................................................................................................................... 11

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

2.4.1 功能描述 ..................................................................................................................... 12

2.5 充值接口，即付款结果通知合作商户(客户端游戏) ..................................................... 12

2.5.1 功能描述 ..................................................................................................................... 12

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

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

2.6 商户查询接口（MallGOP） ........................................................................................ 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.1.1 百度与合作方交互说明

事项

官网

素材提供方 实施方

游戏厂商 百度

实施细节

URL地址由百度提供

备注

充值 百度

1.百度在自己的URL地址上实现选择服务器和提交订单

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

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

厂商和百度

登录页引导到百度，登录成功后通知客户端

充值时

传给厂商的是用户ID

百度通过登录接口传入防沉迷标志位。y:需要防沉，n：不需要防沉迷，不做控制

登录进入游戏（选服页)

查询角色

实时post角色

每日角色文件

帐户体系

百度

百度

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

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

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

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

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

防沉迷 用户输入 厂商和百度

1.1.2 开发检查指南(客户端)

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

提供数据

用户认证

说明

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

百度游戏联运平台--接口说明(客户端游戏)

游戏客户端

服务器编码

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

是否需要创建角色充值

游戏币名称

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

统一登录接口地址

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

客服后台

实时监控

2． 双方验证资料

提供数据

官网地址

合作方提供游戏客户端，需要保证此客户端提供给百度的用户，使用百度的用户名登录

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

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

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

举例：金币,元宝

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

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

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

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

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

说明

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

例如 /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为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.1.4 编码问题

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

【举例】：百度游戏

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

2 客户端游戏

客户端登录协作图：

百度游戏联运平台--接口说明(客户端游戏)

客户端点击图标打开百度的登录页面地址(参照/xyj/reg?n=0)，登录成功后关闭此页面，通知客户端做相应处理

2.1 服务器认证

2.1.1 服务端得到的参数

游戏客户端->合作方服务器(由百度在登录成功页中回传给游戏客户端)

合作方服务器从游戏客户端得到的参数如下：

字段名称

api_key

user_id

必填

是

是

说明

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

用户的百度用户编号id

百度游戏联运平台--接口说明(客户端游戏)

sessionId

timestamp

是

是

用户状态唯一标识

服务请求时间戳，格式：yyyy-MM-dd_HH:mm:ss 特殊处理了一下日期，日期和时间使用_分隔

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

sign

是

备注：百度与客户端交互的时候采用顺序的格式，中间为空格分隔

api_keyxxxx user_idxxxx sessionIdxxxxxxxxxx timestampxxxxxxxxxxxxxxxx signxxxxxxx

sign的签名规则参照

【样例】

假设:api_key=12345 user_id=9876 sessionId=abc1111111 timestamp=2010-04-22 12:12:12

sign=ABCDEFFFFFFFFFF

则百度传递给客户端的参数如下：(通过注表通知客户端)

start游戏简写:12345 9876 abc1111111 2010-04-22_ 12:12:12 ABCDEFFFFFFFFFF

为了便于空格分隔，日期做了特殊处理使用_分隔

例如西游记startxyj:xxxxxxxx

2.1.2 服务端发起玩家登录认证

合作方服务器-> 百度

接口形式：

/rest?api_key=xxxx&api_name=

erLogin&user_id=xxxx&sessionId=xxxxxxx×tamp=xxxxx&v=xxxxx&sing=XXXXXXXXXXXXXXXXXX

服务端发送以下数据和签名串到百度游戏平台进行玩家登录认证。

字段名称

api_key

api_name

format

user_id

sessionId

timestamp

v

必填

是

是

是

是

是

是

是

说明

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

服务名（登录认证接口，erLogin）

Response的格式，XML、JSON

用户的百度用户编号id

用户状态唯一标识

服务请求时间戳

接口版本号,目前是1.0

百度游戏联运平台--接口说明(客户端游戏)

sign

是 签名认证，用于验证签名，不参加签名

2.1.3 返回结果(带防沉迷标志位)

百度->合作方服务器

百度向合作方返回用户标识和防沉迷标志位

字段名称

user_id

cm_flag

必填

是

是

说明

用户的百度用户编号id

防沉迷标志位，取值：y或n

y表示需要防沉迷（用户未填写身份证信息)

n表示不需要控制

XML：

123456

n

JSON：

{response: { username: "123456", cmflag: "n"}}

以下是返回的错误码列表：

返回代码

99

108

104

111

115

错误返回例子：

描述信息

异常

传入参数不符合规则

签名不对

玩家没有登录

用户名不对

111

玩家没有登录

百度游戏联运平台--接口说明(客户端游戏)

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

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

服务请求时间戳

签名认证

2.2.1 返回结果

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

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

参数名称

role_name

类型

String

说明

角色名（url重写，编码是utf-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_?c=gameRole&api_key=123123&user_id=xxxxx&server_id=220×tamp=xxxxxxxxxxxxx&role_name=xxxxxxxxx&action=xxxxxxxxxx&sign=xxxxxxxxxxxx

/game_?c=gameRole为百度提供的实时推送角色的URL

字段名称

api_key

必填

是

是否参与签名 说明

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

用户的百度用户编号id

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

服务请求时间戳

用户角色名角色名（需要URLEncode以UTF-8进行编码）

CREATE:创建角色 DELETE:删除角色

签名认证

user_id

server_id

是

是

是

是

timestamp

role_name

是

是

是

是

action

sign

是

是

是

注意：只支持POST方式

调用方法，参照newJavaDemo中的PostRoleServlet和

请求返回值：无

百度游戏联运平台--接口说明(客户端游戏)

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

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

请求返回值：

【通知方式】

是

是

是

１．前台WEB转向通知

通过用户浏览器转向到游戏厂商对应的支付通知回调地址。

２．后台通知

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）

扩展功能，可以后期开发，主要用于对帐和验证订单有效性

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

必填

是

是

说明

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

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

百度游戏联运平台--接口说明(客户端游戏)

format

order_id

timestamp

v

sign

请求返回值：

是

是

是

是

是

需要Response的格式，XML、JSON。

商户订单号

服务请求时间戳

接口版本号（目前是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

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

请求参数:

字段名称

api_key

api_name

format

sdatetime

edatetime

timestamp

sign

v

请求返回值:

必填

是

是

是

是

是

是

是

是

说明

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

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

Response的格式，XML、JSON

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

结束时间，精确到秒

服务请求时间戳

签名认证

接口版本号（目前是1.0）

返回值 描述

百度游戏联运平台--接口说明(客户端游戏)

result

orderNum

money

sdatetime

edatetime

【调用范例】

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

订单笔数

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

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

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

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

无数据：

有数据：

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

请求参数:

字段名称

api_key

api_name

必填

是

是

说明

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

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

Response的格式，XML、JSON

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

结束时间，精确到秒

服务请求时间戳

接口版本号（目前是1.0）

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

format

sdatetime

edatetime

timestamp

v

sign

请求返回值:

是

是

是

是

是

是

百度游戏联运平台--接口说明(客户端游戏)

返回值

result

orderNum

money

sdatetime

edatetime

描述

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

订单笔数

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

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

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

【调用范例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

JSON：

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

无数据例子：

0

百度游戏联运平台--接口说明(客户端游戏)

错误返回例子：

126

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

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

2.7.1 功能描述

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

2.7.2 接口参数

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

/rest

请求参数:

字段名称

api_key

api_name

必填

是

是

说明

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

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

Response的格式，XML、JSON

接口版本号（目前是1.0）

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

查询的域，指定为id

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

签名认证

format

v

username

是

是

是

fields

timestamp

sign

请求返回值:

是

是

是

返回值

result

描述

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

百度游戏联运平台--接口说明(客户端游戏)

id

用户的user_id

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

返回代码

102

103

104

105

113

114

121

122

【调用范例】

Form表单以POST方式提交

描述信息

调用接口不能为空

应用id不对

签名认证不对

用户不存在

服务请求时间戳为空

接口版本号为空

查询字段不能为空

查询字段不对