对战游戏结果上报接口

/v3/gamebar/report_battle_result

pf=qzone pf=wanba_ts

本接口用于对战类游戏在对战结束后,游戏侧向空间小游戏后台上报对战结果使用

URL

https://api.urlshare.cn/v3/gamebar/report_battle_result

私有参数

参数名称 是否必须 类型 描述
data string 存储对战结果的json字符串进行base64编码后的结果,该json包含以下字段

对战结果json结构定义

参数名称 是否必须 类型 描述
battle_id string 玩吧后台生成的对战ID,进行游戏时通过请求URL传递给游戏后台
lst_group 数组 每个分组的对战结果
lst_user 数组 需要更新战力数据的用户列表,战力数据用户小游戏后台实现的相似战力玩家匹配逻辑
abnormal_game 整数 是否异常对局

分组对战结果lst_group节点结构定义

参数名称 是否必须 类型 描述
group_id 整数 分组ID,玩吧后台生成
is_winner 整数 取值[0,1]有效,是否获胜分组,group_id相同的全部玩家拥有相同的胜负结果

战力数据lst_user节点结构定义

参数名称 是否必须 类型 描述
openid 字符串 QQ开放平台给用户分配的openid
battle_level 整数 取值[0,20]有效,由游戏方进行玩吧战力评分

返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。

错误返回码说明

本接口私有错误返回码:

  • -9999: 请求data参数不是有效的base64编码数据
  • -9998: 请求data参数进行base64解析后不是正确的json
  • -9997: 请求json中某些字段取值不合法
  • -9996: 请求json中存在无效的group_id
  • -9995: 请求json中存在无效的openid
  • -9994: 请求json中lst_group数组为空
  • -9899:后端读写存储操作,建议重试一次