#

SUD

简要描述

  • 服务端根据game_round_id, report_game_info_key(自定义游戏局ID), filter_types查询游戏上报信息
  • 数据只支持查询一个月以内的游戏局信息
  • 当前接口针对每个app_id请求限制频率为10次/秒

请求URL

请求方式

  • 传输协议:HTTPS
  • 请求方法:POST
  • 参数以body传递,格式为json(见请求示例)
  • Header中需要添加:Content-Type: application/json;charset=utf-8
  • Header中需要添加:认证请求头Authorization

请求头 [Authorization]

请求参数

参数名 必选 类型 说明
report_game_info_key 特殊可选 string 上报游戏信息时传入的上报信息key,和game_round_id不能同时为空。
game_round_id 和 reoprt_game_info_key 如果同时存在优先取 game_round_id
game_round_id 特殊可选 string 游戏局id, 和report_game_info_key不能同时为空
filter_types 可选 string[] 过滤上报类型,数组格式, 不传则返回所有的上报类型。包括但不限于:
["game_start", "game_settle"]

请求示例

{
  "game_round_id": "de56b6lzi1a7-cqhuiaj1wlh6-apgxupfcpbrf"
}

返回参数

  • BaseResp
参数名 必选 类型 说明
ret_code int 响应码
ret_msg string 响应信息
data map 响应数据 <上报类型, 上报数据>
  • 上报类型 对应表
上报类型 上报数据 说明
game_start game_start_object 战斗开始通知
game_settle game_settle_object 战斗结算通知
  • game_start_object
参数名 必选 类型 说明
mg_id int64 游戏id
mg_id_str string 小游戏id数值型兼容字段(nodejs服务请使用当前字段)
room_id string 房间id
game_mode int32 游戏模式
game_round_id string 本局游戏的id (重复上报,使用该字段去重)
battle_start_at int32 战斗开始时间(秒)
players player_object player_object 数组
report_game_info_key string 自定义上报信息key
  • player_object
参数名 必选 类型 说明
uid string 用户ID,机器人为空字符
is_ai int32 0:普通用户,1:机器人
  • game_settle_object
参数名 必选 类型 说明
mg_id int64 游戏id
mg_id_str string 小游戏id数值型兼容字段(nodejs服务请使用当前字段)
room_id string 房间id
game_mode int32 游戏模式
game_round_id string 本局游戏的id (重复上报,使用该字段去重)
battle_start_at int32 战斗开始时间(秒)
battle_end_at int32 战斗结束时间(秒)
battle_duration int32 战斗总时间(秒)
results player_result_object player_result_object 数组
results_url string 玩家结果数据下载地址 (有效时间 1小时)
report_game_info_key string 自定义上报信息key
  • player_result_object
参数名 必选 类型 说明
uid string 用户ID,机器人为空字符
rank int32 排名从1开始,平局排名相同
is_escaped int32 0:正常,1:逃跑
is_ai int32 0:普通用户,1:机器人
role int32 0:表示没有角色信息,玩家在游戏中的角色 游戏role 说明
score int32 玩家当前局得到的分数
commission_score int32 佣金抽成积分
is_win int32 结果 0:表示没有信息,1:输,2:赢,3:平局
award int32 奖励
extras string 扩展参数扩展说明
is_managed int32 是否托管 0:未托管 1:托管

返回示例

{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "game_start": {
      "mg_id": 1468434723902660610,
      "room_id": "9009",
      "report_game_info_extras": "world!",
      "mg_id_str": "1468434723902660610",
      "players": [
        {
          "is_ai": 0,
          "uid": "515b8e0b"
        },
        {
          "is_ai": 0,
          "uid": "09d032dd"
        }
      ],
      "game_mode": 1,
      "report_game_info_key": "key!@!1",
      "game_round_id": "de56b6lzi1a7-cqhuiaj1wlh6-apgxupfcpbrf",
      "battle_start_at": 1652426471
    },
    "game_settle": {
      "mg_id": 1468434723902660610,
      "room_id": "9009",
      "battle_end_at": 1652425480,
      "report_game_info_extras": "hello",
      "mg_id_str": "1468434723902660610",
      "game_mode": 1,
      "report_game_info_key": "key!@!1",
      "game_round_id": "de56b6lzi1a7-cqhuiaj1wlh6-apgxupfcpbrf",
      "battle_start_at": 1652426471,
      "results": [
        {
          "is_ai": 0,
          "uid": "b71e0ced",
          "score": 0,
          "commission_score": 0,
          "rank": 1,
          "is_escaped": 0
        },
        {
          "is_ai": 0,
          "uid": "17864733",
          "score": 0,
          "commission_score": 0,
          "rank": 2,
          "is_escaped": 0
        }
      ],
      "battle_duration": 10
    }
  }
}

results matching ""

    No results matching ""