#

SUD

简要描述

  • 游戏服务端上报游戏接入方的游戏的数据

请求URL

  • 分为测试环境和生产环境，需要通知Sud分别进行配置
  • 生产环境地址需要正式上线部署后才能生效

请求方式

  • https
  • POST
  • 参数为Json格式，放在body内

回调验签

客户服务端需对回调内容进行验签，保证数据的完整性。

请求参数（可能会新增加字段，请接入方保持新增加字段兼容性）

参数名 必选 类型 说明
report_type 是 string 上报类型
report_msg 是 object 上报数据对象
uid 是 string 用户id，请求get_user_info 接口返回uid参数(后续不再维护，建议不关注)
ss_token 是 string 用户ss_token，请求get_sstoken 接口返回ss_token参数(后续不再维护，建议不关注)
report_type 参数对应表
参数类型 参数值 report_msg 对应类型 说明
report_type game_start game_start_object 战斗开始通知
report_type 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_extras 否 string 游戏上报信息扩展参数（透传），取值范围：长度不超过1024字节，超过则截断
report_game_info_key 否 string 游戏上报信息扩展参数（透传），取值范围：长度不超过64字节，超过则截断。接入方服务端可以根据这个字段来查询一局游戏的数据
  • player_object
参数名 必选 类型 说明
uid 是 string 接入方uid
is_ai 是 int32 0:普通用户，1:机器人
ai_level 否 int32 ai等级0:简单ai,1:简单ai,2:中级ai,3:高级ai
  • 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_extras 否 string 游戏上报信息扩展参数（透传），取值范围：长度不超过1024字节，超过则截断
report_game_info_key 否 string 游戏上报信息扩展参数（透传），取值范围：长度不超过64字节，超过则截断。接入方服务端可以根据这个字段来查询一局游戏的数据
extras 否 string 扩展参数扩展说明
  • player_result_object
参数名 必选 类型 说明
uid 是 string 接入方uid
rank 是 int32 排名从1开始，平局排名相同
is_escaped 是 int32 0:正常，1:逃跑
is_ai 是 int32 0:普通用户，1:机器人
ai_level 否 int32 ai等级0:简单ai,1:简单ai,2:中级ai,3:高级ai
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:托管

game_start 请求示例

{
  "report_type": "game_start",
  "report_msg": {
    "mg_id": 1461227817776713818,
    "mg_id_str": "1461227817776713818",
    "room_id": "xxx123",
    "game_mode": 1,
    "game_round_id": "ce56b6lzi1a7-cehorlmy01pq-cqkdd39jyrmz",
    "battle_start_at": 1638845715,
    "players": [
      {
        "uid": "u2",
        "is_ai": 0,
        "ai_level": 1
      },
      {
        "uid": "u1",
        "is_ai": 0,
        "ai_level": 1
      }
    ],
    "report_game_info_extras": "custom param",
    "report_game_info_key": "custom param"
  },
  "uid": "u1",
  "ss_token": "fyRTOsubRLCGrRvKoKm7wIcMM1DL7cfb"
}

game_settle 请求示例

{
  "report_type": "game_settle",
  "report_msg": {
    "mg_id": 1461227817776713818,
    "mg_id_str": "1461227817776713818",
    "room_id": "xxx123",
    "game_mode": 1,
    "game_round_id": "ce56b6lzi1a7-cehorlmy01pq-cqkdd39jyrmz",
    "battle_start_at": 1638845715,
    "battle_end_at": 1638845720,
    "battle_duration": 5,
    "results": [
      {
        "uid": "u2",
        "rank": 1,
        "is_escaped": 0,
        "is_ai": 0,
        "ai_level": 1,
        "role": 0,
        "score": 1,
        "commission_score": 0,
        "is_win": 1
      },
      {
        "uid": "",
        "rank": 2,
        "is_escaped": 0,
        "is_ai": 1,
        "ai_level": 1,
        "role": 0,
        "score": 2,
        "commission_score": 0,
        "is_win": 0
      }
    ],
    "report_game_info_extras": "custom param",
    "report_game_info_key": "custom param"
  },
  "uid": "u1",
  "ss_token": "fyRTOsubRLCGrRvKoKm7wIcMM1DL7cfb"
}

返回参数

参数名 必选 类型 说明
ret_code 是 int32 错误码，0:成功，其他表示错误
ret_msg 是 string 错误信息
sdk_error_code 否 int32 sdk错误码，0:成功，其他表示错误
data 否 json data数据，如果有值务必是json格式

返回示例

{
  "ret_code": 0, // 0:成功，其他表示错误
  "ret_msg": ""
}
备注
  • 请求失败或者返回ret_code!=0，会按照时间间隔60, 60, 60, 240, 600, 600, 3600, 7200, 14400, 28800秒依次去重试, 之后就不再重试

results matching ""

    No results matching ""