Skip to content

弹题排行榜

GET /api/app/course/{courseId}/task/{taskId}/marker/{markerId}/ranking

返回弹题排行榜,包括我的排名和 TOP20。

  • myEntry:当前轮成绩 + 排名
  • topList:所有学员最佳轮成绩排名(TOP20)

位置参数

参数类型必填说明
courseIdnumber课程 ID
taskIdnumber任务 ID
markerIdnumber弹题 ID

响应

字段类型说明
myEntryobject / null我的排名信息(当前轮);无成绩时为 null
myEntry.ranknumber我的排名;同分同名次
myEntry.nicknamestring昵称
myEntry.avatarstring头像 URL(已转换)
myEntry.scorenumber我的当前轮总分
topListarrayTOP 榜单,默认 20 条(最佳轮成绩)
topList[].ranknumber名次;同分同名次
topList[].nicknamestring昵称
topList[].avatarstring头像 URL(已转换)
topList[].scorenumber该用户最佳轮总分
topList[].isCurrentUserboolean是否为当前用户

响应示例

json
{
  "myEntry": {
    "rank": 2,
    "nickname": "Aiden",
    "avatar": "https://cdn.example.com/avatar1.png",
    "score": 3200
  },
  "topList": [
    {
      "rank": 1,
      "nickname": "Aiden",
      "avatar": "https://cdn.example.com/avatar1.png",
      "score": 3600,
      "isCurrentUser": true
    }
  ]
}

异常

错误码HTTP说明
COURSE_VIDEO_MARKER_TASK_MISMATCH400任务与弹题不匹配
COURSE_VIDEO_MARKER_NOT_FOUND404弹题不存在