东梦接口平台 / 究极院APP-V3 / 排位赛-排队

排位赛-排队

接口描述: 排队等待匹配排位赛

HTTP/HTTPS
请求协议
GET/POST
请求方式
UTF-8
编码格式
JSON
返回格式

接口参数

参数名字类型是否必须默认值其他说明
token字符串可选-token, 登录接口返回的token值
gameType字符串可选-排位赛可以不传,系统自动分配。游戏类型:sight:视奏大作战, quick:快速音,dream:梦乐团
isResetting字符串必须0是否重新排队:默认0不重置、1重新开始排队
roomNum字符串可选2教室人数(偶数):1V1为2人、2V2为4人、3V3为6人
teamNum字符串可选-团队人数,几人排位
teamUserUids字符串可选-团队成员uid,英文逗号隔开

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
msg字符串提示信息,失败时的错误提示

在线测试   

参数是否必须
service 必须
token 可选
gameType 可选
isResetting 必须
roomNum 可选
teamNum 可选
teamUserUids 可选

客户端请求示例

{
  "ret": 200,
  "data": [
    {
      "id": 6, // 学员排位赛段位星级表id
      "uid": "12ad0ee1013f59a27afa907d9a61492e44851ca1", // 学员uid
      "fight_rank": 30, // 当前排位阶位【已弃用,排位按里程牌匹配】
      "fight_stage": 4, // 当前排位段位
      "fight_star": 0, // 当前排位星级
      "fight_score": "30.0", // 排位累计当前星级分
      "fight_type": "normal", // 排位类型:locate定位赛、normal常规赛、star星级晋级赛、stage段位晋级赛、other其他赛式(如里程碑)
      "userUid": "12ad0ee1013f59a27afa907d9a61492e44851ca1",  // 学员uid
      "teamUserUids": [  // 团队其他学员uid
        ""
      ],
      "lineupTime": 1688020634, // 匹配时间
      "realname": "张云利", // 学员真实名称
      "pet_head": 32, // 宠物头像id
      "fight_score_subtotal": 100, // 当前星级总分
      "abilityTotal": 5131, // 总战力值
      "abilitys": [ // 学员当前战力明细
        0,
        0,
        1057,
        1800,
        2274,
        0,
        0,
        0
      ]
    }
  ],
  "msg": ""
}

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
500表示服务端内部错误

本文档生成时间:2025-12-26 15:26:14