HTTP/HTTPS
请求协议
东梦接口平台 / 究极院APP-V3 / 获取星球任务相关数据
获取星球任务相关数据
接口地址:https://dmapi.v3.doyure.com/api/ultima.php?s=Ultima.UserStarTask.StarTask
接口描述: 获取学员当前任务相关数据:周任务完成情况、今日任务在线时长、宝箱是否开启
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| 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": ""
}错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400,客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406,access_token令牌校验不通过 |
| 407 | ret=407,app_key权限不足,或未知应用 |
| 408 | ret=408,当前用户禁止使用,或用户未登录 |
| 500 | 表示服务端内部错误 |
本文档生成时间:2025-12-26 15:22:54