HTTP/HTTPS
请求协议
东梦接口平台 / 究极院APP-V3 / 定位里程碑
定位里程碑
接口地址：https://dmapi.v3.doyure.com/api/ultima.php?s=Ultima.Milestone.LocateMilestone
接口描述： 获取解锁里程碑关卡游戏数据
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| token | 字符串 | 可选 | - | token, 登录接口返回的token值 | |
| userUid | 字符串 | 可选 | - | 学员uid |
返回字段
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据，由各自接口指定，通常为对象 |
| msg | 字符串 | 提示信息，失败时的错误提示 |
在线测试
| 参数 | 是否必须 | 值 |
|---|---|---|
| service | 必须 | |
| token | 可选 | |
| userUid | 可选 |
客户端请求示例
{
"ret": 200,
"data": [
{
"id": 1014,
"milestone_id": 401,
"title": "里程碑-视奏单音-定位1",
"ability_id": 2,
"game_type": "sight",
"task_no": "0",
"img": "https://static.doyure.com/dmapi/star_task/sight/MS-SR-4.png",
"file_type": "text",
"file_path": "48-1,50-1,52-1,53-1,55-1,57-1,59-25,60-14,60-15,62-1,64-9,65-18,67-1,69-1,71-1,72-1",
"note_pass_num": null,
"sort": 0,
"star_1": "1.0",
"star_2": "5.0",
"star_3": "10.0",
"memo": null,
"created_at": "2023-11-28 18:00:00",
"updated_at": "2023-12-26 11:50:23",
"deleted_at": null,
"islock": 1,
"result": "0.00",
"star_num": 0,
"main_title": "里程碑 - 视奏大作战",
"subtitle": "里程碑 - 视奏大作战",
"intro": "https://static.doyure.com/dmapi/games/szdzz.png",
"rank": 0,
"game_id": 14,
"duration": 60,
"type": 4,
"type_desc": "游戏",
"files": "",
"games": {
"id": 14,
"game_id": 14,
"game_name": "视奏大作战",
"game_tour": "https://static.doyure.com/dmapi/games/jzdtz.png",
"notes": [
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_55-1",
"num": "55-1"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_48-1",
"num": "48-1"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-15",
"num": "60-15"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_69-1",
"num": "69-1"
},
{
"id": 0,
"name": "gaming_rhy_s_71-1",
"num": "71-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_53-1",
"num": "53-1"
},
{
"id": 0,
"name": "gaming_rhy_s_52-1",
"num": "52-1"
},
{
"id": 0,
"name": "gaming_rhy_s_57-1",
"num": "57-1"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_59-25",
"num": "59-25"
},
{
"id": 0,
"name": "gaming_rhy_s_65-18",
"num": "65-18"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_72-1",
"num": "72-1"
},
{
"id": 0,
"name": "gaming_rhy_s_50-1",
"num": "50-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
},
{
"id": 0,
"name": "gaming_rhy_s_62-1",
"num": "62-1"
},
{
"id": 0,
"name": "gaming_rhy_s_64-9",
"num": "64-9"
},
{
"id": 0,
"name": "gaming_rhy_s_67-1",
"num": "67-1"
},
{
"id": 0,
"name": "gaming_rhy_s_60-14",
"num": "60-14"
}
],
"notes2": [],
"bgm": {
"file": "http://static.doyure.com/dmapi/dmapi/b20d220220927142946.mp3",
"title": "视奏大作战背景音乐",
"min_interval": 0,
"min_intervals": [],
"pre_beat_num": 0,
"total_parts": 0,
"tonality": "",
"parts": [],
"isMetronome": 0,
"speed": 0,
"rate": 1
},
"tolerant_times": 120, // 允许错误数量
"drop_num": 3, // 下落音符数，最多3个
"drop_gap": 5, // 下落间隔
"drop_speed": 5, // 下落速度
"show_mode": 0 // 显示模式：0默认下落、1随机显示
}
}
],
"msg": ""
}错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400，客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406，access_token令牌校验不通过 |
| 407 | ret=407，app_key权限不足，或未知应用 |
| 408 | ret=408，当前用户禁止使用，或用户未登录 |
| 500 | 表示服务端内部错误 |
本文档生成时间：2025-12-26 15:29:47