对战游戏结果上报接口
/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]有效，由游戏方进行玩吧战力评分 |
返回参数说明
错误返回码说明
本接口私有错误返回码：
- -9999: 请求data参数不是有效的base64编码数据
- -9998: 请求data参数进行base64解析后不是正确的json
- -9997: 请求json中某些字段取值不合法
- -9996: 请求json中存在无效的group_id
- -9995: 请求json中存在无效的openid
- -9994: 请求json中lst_group数组为空
- -9899：后端读写存储操作，建议重试一次
