动网先锋文档中心

DOVO联运通用版接入合作方接口

手游SDK
数据中心接入
新游戏接入流程
手游接入规范
一:背景 二:数据记录规范
三:数据记录内容
1、用户表 2、充值表 3、玩家登录日志 4、玩家离线日志 5、玩家在线日志 6、等级升级日志 7、任务日志 8、金币流量 9、玩家操作日志 10、游戏产出道具日志纪录 11、新用户流失跟踪表(t_userLose)
四:特殊游戏接口
1、单服在线数接口 2、单服分平台、渠道在线接口
页游接入规范
一、背景 二、数据记录规范
三、数据记录内容
1、用户表 2、充值表 3、新用户流失跟踪表 4、等级升级日志 5、任务日志 6、玩家登录日志 7、玩家离线日志 8、玩家在线日志 9、金币流量 10、玩家操作日志 11、游戏产出道具日志纪录
四、特殊游戏接口
1、单服在线数接口 2、游戏log保存数据时额外接口
外部游戏网管接入规范
客服系统提问及FAQ
公共参数说明
客服系统FAQ
1获取FAQ分类 2分类的标题 3FAQ的详细内容 4FAQ评价接口 5热点FAQ接口 6FAQ搜索接口
GM提问
1提问接口 2工单评价接口 3玩家追问接口 4删除工单 5工单列表 6工单详情 7删除全部工单
客服公告
客服公告列表 客服公告详情
DOVO联运通用版接入合作方接口
通用接口
接口说明 登陆接口 充值接口 角色账号验证接口 角色信息查询接口 禁言、踢下线接口 封号接口 游戏服每天5分钟在线接口 百度实时post角色信息接口
客服系统提问及FAQ(移动版)
客服提问及FAQ
客服系统提问及FAQ(Flash封装包)
Flash封装包对接说明
客服GM工具接口
页游接入GM工具
1、优先级别 2、请求格式及方式 3、返回数据格式 4.1、玩家查询 4.2、获取日志类型 4.3、玩家日志查询 4.4、游戏登录功能 4.5、获取 封号/禁言 列表 4.6、添加 封号/禁言 4.7、删除 封号/禁言 4.8、邮件发放 4.9、获取道具卡列表 4.10、获取需要发送的道具 4.11、发送道具 4.12、背包查询 4.13、调整背包物品数量 4.14、添加公告 4.15、获取公告列表 4.16、编辑公告 4.17、删除公告 4.18、充值查询 4.19、获取邮件列表 4.20客服回复GM图标闪烁 5、开发测试工具
手游接入GM工具
1、优先级别 2、请求格式及方式 3、返回数据格式 4.1、玩家查询 4.2、获取日志类型 4.3、玩家日志查询 4.4、游戏登录功能 4.5、获取 封号/禁言 列表 4.6、添加 封号/禁言 4.7、删除 封号/禁言 4.8、邮件发放 4.9、获取道具卡列表 4.10、获取需要发送的道具 4.11、发送道具 4.12、背包查询 4.13、调整背包物品数量 4.14、添加公告 4.15、获取公告列表 4.16、编辑公告 4.17、删除公告 4.18、充值查询 4.19、获取邮件列表 4.20、查询武将 4.21、剔除玩家 4.22、维护管理 4.23、白名单 4.24、添加白名单 4.25、删除白名单 4.26、装备查询 4.27、家将查询 4.28、坐骑查询 4.29、宠物查询 4.30、获取活动类型、及活动列表 4.31、开启活动 4.32、查询开启的活动列表 4.33、删除开启的活动 5、开发测试工具
uwan接口
登录接口 文化部审核接口 充值接口

实时post角色信息接口

该接口请游戏自行实现POST(下面的文档直接拷贝百度文档,有问题请参考官方最新文档)

合作商户在玩家建立角色、角色升级、删除角色时,向百度的服务器通过POST发送该用户在对应服务器的角色信息

接口形式:
http://youxi.baidu.com/roleAction/gameRolePost.jsp

其中:只支持POST方式

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

http://youxi.baidu.com/roleAction/gameRolePost.jsp

贴吧平台提供的实时推送角色的URL

http://wanba.baidu.com/roleAction/gameRolePost.jsp

 

字段名称

必填

类型

说明

api_key

String

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

user_id

Long

用户的百度用户编号id

server_id

string

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

timestamp

string

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

时间格式2010-04-26 11:09:52

role_name

string

用户角色名角色名,中文角色名URL.Eecode编码后加入签名

role_time

string

角色更新时间或者创建时间, 格式yyyyMMddhhmmss
时间格式:20140425115150

action

String

CREATE:创建角色; DELETE:删除角色 UPDATE 角色更新

multi_flag

string

是否存在多角色,默认N,即不存在;Y存在多角色

role_level

int

角色等级

role_online_time

int

(精确到分,每日累计在线时间,单位为分钟)

role_count_online_time

int

(精确到分,累计该角色所有在线时间,单位为分钟)

sign

string

签名认证,详见文档2.5.1说明

 

返回值

说明

recive ok

Post成功

ERROR_100

参数错误,或者参数格式错误,返回具体说明

ERROR_200

签名错误

ERROR_300

Post失败,加入重试机制

 

注意:RoleName需要decode前加入签名验证。

roleName传送至百度平台时encode一次。相当于对roleName做两次encode。

参与加密的roleName只做一次encode就可以了。

如上图为正确显示的POST成功的机制。

如果实时POST推送时发现时间没有推送,请检查action参数中的update数值是否正确

1.1  Post时机

用户等级是每增加5级时,比如1611等;

如果该服是多角色,返回当前登录的角色数据


1.2  签名算法说明

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

 

1.2.1   签名算法生成规则

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

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

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

1.2.2   签名算法详细示例    

第一步:在未加入签名认证之前百度游戏服务器向合作商户登录游戏服务器POST/GET下面的请求详细信息为:

 

user_id=672134&api_key=27dccf180127259d89d81737e0736700&server_id=220&cm_flag=y &timestamp=2010-04-26 11:09:52

 

第二步:经过第一步字典排序后,request的参数串就变为:

 

api_key=27dccf180127259d89d81737e0736700cm_flag=yserver_id=220timestamp=2010-04-26 11:09:52user_id=672134

 

第三步:示例中的游戏app_secret9bc193eb243824610124382461e60002,则经过第二步放参数的第一位,去掉参数间的等号以及除时间戳内日期和小时之间以外的全部空格,示例中request的参数串变为:

  

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

 

第四步:经过第三步MD5计算后,示例中生成的MD5值为:54d458365f74a3396917ed9f3fd8336d,则应用向百度游戏服务器最终POST请求的参数为:

 

api_key=27dccf180127259d89d81737e0736700&cm_flag=y&server_id=220&timestamp=2010-04-26 11:09:52&user_id=672134&sign=54d458365f74a3396917ed9f3fd8336d

 

sign最后统一为大写:

api_key=27dccf180127259d89d81737e0736700&cm_flag=y&server_id=220&timestamp=2010-04-2611:09:52&user_id=672134&sign=54D458365F74A3396917ED9F3FD8336D