东梦接口平台 / 究极院APP-V3 / 获取星球任务相关数据

获取星球任务相关数据

接口描述: 获取学员当前任务相关数据:周任务完成情况、今日任务在线时长、宝箱是否开启

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

接口参数

参数名字类型是否必须默认值其他说明
token字符串可选-token, 登录接口返回的token值

返回字段

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

在线测试   

参数是否必须
service 必须
token 可选

客户端请求示例

{
  "ret": 200,
  "data": {
    "weekTasks": [ // 周任务列表
      {
        "book_name": "菲一 课程和乐理", // 书目名
        "song_name": "十秒之歌", // 曲目名称
        "star_num": "0.0", // 获取星级数
        "score": "0.00", // 最新成绩
        "song_subtitle": "十秒之歌",
        "song_step_name": "步骤五",
        "plan_name": "方案一",
        "img": "http://static.doyure.com/dmapi/free_training/songs/faber/faber-1-c-2.mxl",
        "training_mode": 2,
        "hand_type": 2,
        "speed": "116.0"
      },
      {
        "book_name": "菲一 课程和乐理",
        "song_name": "十秒之歌",
        "star_num": "0.0",
        "score": "1.00",
        "song_subtitle": "十秒之歌",
        "song_step_name": "步骤五",
        "plan_name": "方案一",
        "img": "http://static.doyure.com/dmapi/free_training/songs/faber/faber-1-c-2.mxl",
        "training_mode": 2,
        "hand_type": 2,
        "speed": "116.0"
      },
      {
        "book_name": "菲一 课程和乐理",
        "song_name": "行驶在G谱号上",
        "star_num": "0.0",
        "score": "0.00",
        "song_subtitle": "行驶在G谱号上",
        "song_step_name": "步骤五",
        "plan_name": "方案一",
        "img": "http://static.doyure.com/dmapi/free_training/songs/faber/faber-1-c-3.mxl",
        "training_mode": 2,
        "hand_type": 2,
        "speed": "104.0"
      }
    ],
    "isOpenWeekBox": 1, // 周宝箱是否可以开启:0不能开宝箱、1可以开启、2已开启
    "everydayTaskTypes": [ // 每日任务类型
      {
        "id": 1, // 类型id
        "title": "综合视奏", // 类型标题
        "preview_time": 60, // 预览时长(单位:s)
        "max_result": 0, // 今日最高成绩
        "task_status": 0, // 任务状态:0未通过、1已通过、2已放弃
        "is_pass": 0, // 是否通过:0不通过、1通过
        "is_open_box": 0 // 是否开启宝箱:1已开启、0未开启
      },
      {
        "id": 2,
        "title": "综合视奏",
        "preview_time": 60,
        "max_result": 0,
        "task_status": 0,
        "is_pass": 0,
        "is_open_box": 0
      },
      {
        "id": 3,
        "title": "手指灵活",
        "preview_time": 0,
        "max_result": 0,
        "task_status": 0,
        "is_pass": 0,
        "is_open_box": 0
      },
      {
        "id": 4,
        "title": "专项能力",
        "preview_time": 0,
        "max_result": 0,
        "task_status": 0,
        "is_pass": 0,
        "is_open_box": 0
      }
    ],
    "isOpenEverydayBox": 0, // 每日任务宝箱状态:0待领取、1已领取、2不可(重复)领取
    "everydayTaskPercent": "1/4", // 今日任务完成进度
    "dailyBoxMp4": "http://static.doyure.com/ultima/boxs/mp4/daily.mp4", // 打开每日任务宝箱视频
    "weekBoxMp4": "http://static.doyure.com/ultima/boxs/mp4/week.mp4", // 打开周任务宝箱视频
    "finish_percent": "50%", // 任务完成度
    // ---------------------------------------------  以下接口字段可弃用  --------------------------------------------- //
    "dailyTask": { // 今日任务成绩
      "uid": "5d83ec6d58511207c5663a98aeb549a4750f7dd8",
      "score": "95", // 最近成绩
      "duration": "9", // 当前累计时长
      "drillStatus": 0, // 任务状态:0未领取、1已领取
      "drillTime": 1684221975
    },
    "isOpenDailyBox": 1 // 日宝箱是否可以开启:0不能开宝箱、1可以开启、2已开启
  },
  "msg": ""
}

错误列表

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

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