漫步网关

单曲信息。

• id 歌曲 ID，或单曲分享链接。

• name 歌名 · artist 歌手 · id 歌曲 ID
• url pic lrc 再请求本网关的播放、封面、歌词地址

点击「发送测试」查看返回

歌单曲目。网易云最多返回 200 首。

• id 歌单 ID，或歌单分享链接。

• name 歌单名 · pic 封面
• data 曲目数组，字段与 song 相同

点击「发送测试」查看返回

用户的歌单列表。网易云含创建和收藏；QQ 只保证创建的歌单，收藏未公开则跳过。

• id 网易云用户 UID，或 QQ 号。

• id 歌单 ID · name 名称 · pic 封面
• songCount 歌曲数，未知为 -1 · creator 创建者
• 用户 ID 无效时 400 {"error":"请输入有效的网易云用户 ID"} 或 {"error":"请输入有效的 QQ 号"}

点击「发送测试」查看返回

分类歌单广场。由网关去拉，避免手机直连拿到空列表。后台需已配置对应平台 Cookie。

• id 网易云填分类名，如 日语、华语。QQ 填歌单广场 categoryId，日语是 169，不是歌单 id。
• limit 条数，1–30，默认 15。
• offset 跳过条数，从 0 起。下一页加上本次返回条数。

• 字段与 user 相同：id name pic，QQ 另有 songCount creator
• 空数组表示这个分类没有歌单
• 分类无效时 400 {"error":"缺少分类名"} 或 {"error":"缺少分类 id"}

点击「发送测试」查看返回

歌手的歌曲。

• id 网易云为歌手数字 ID。QQ 为 singermid，也可填歌手名。

• 字段与 song 相同

点击「发送测试」查看返回

搜索单曲。

• id 关键词。
• page 页码，从 1 起，默认 1。
• limit 每页条数，1–50，默认 30。

• 字段与 song 相同

点击「发送测试」查看返回

播放地址。无损及以上需要对应平台的会员 Cookie。选档前可先调 qualities 探测各档是否可用。

• id 歌曲 ID。
• br 音质，也可用 quality 或 level。默认 320。
• 128 / standard 标准 · 320 / exhigh 极高 · flac / lossless 无损 · hires Hi-Res · jymaster 母带

• 302 跳转到音频地址
• 地址以 @ 开头时改为 200 纯文本，内容就是该字符串
• 拿不到链接时 403 {"error":"no url"}

点击「发送测试」查看返回（默认不跟随 302，便于看 Location）

按曲探测各音质档在当前 Cookie / 资源下是否可用。客户端选下载音质前调用，用于灰掉不可用档。返回元数据可用性，不返回音频 URL；真正取链仍走 type=url&br=…。

• id 歌曲 ID（可粘贴分享链接）。
• server 平台，可省略（链接解析时自动带出）。

• id · server 实际使用的歌曲与平台
• max 歌曲资源侧最高音质（有文件）
• downloadMax 当前 Cookie 大致可下载最高档
• qualities[] 各档列表：
  • key 档位名：standard · higher · exhigh · lossless · hires · jyeffect · sky · jymaster
  • br 传给 type=url 的推荐值（如 128 / 320 / flac）
  • label 展示文案
  • available 是否建议可选
  • reason 不可用时：no_resource 曲目无该档 · need_vip Cookie/会员不足

• 网易云：歌曲详情音质块 + privilege（maxBrLevel / dlLevel 等）
• QQ：歌曲详情 track_info.file 各 size_*，size > 0 视为有资源
• 无 Cookie / 无 VIP 时高档多为不可用；最终能否播仍以 url 为准

{
  "server": "netease",
  "id": "347230",
  "max": "hires",
  "downloadMax": "exhigh",
  "qualities": [
    { "key": "standard", "br": "128", "label": "标准 128k", "available": true },
    { "key": "exhigh", "br": "320", "label": "极高 320k", "available": true },
    { "key": "lossless", "br": "flac", "label": "无损 FLAC", "available": false, "reason": "need_vip" },
    { "key": "hires", "br": "hires", "label": "Hi-Res", "available": false, "reason": "need_vip" },
    { "key": "jymaster", "br": "jymaster", "label": "超清母带", "available": false, "reason": "no_resource" }
  ]
}

点击「发送测试」查看返回

歌词，LRC 文本。

• id 歌曲 ID。

• 标准 LRC，含时间轴

点击「发送测试」查看返回

封面图。

• id 歌曲 ID。

• 302 跳转到图片地址

点击「发送测试」查看返回（默认不跟随 302，便于看 Location）

Cookie 监测告警。必须带 API Token。后台要开启通知（Webhook 地址可留空），否则 alerts 为空。只返回这个 Token 创建者名下的 Cookie。

• since 毫秒时间戳，只返回这之后的告警。默认 0。

• success · data.monitorEnabled · data.webhookEnabled · data.intervalMinutes
• data.alerts[]：id type timestamp platform platformName title message
• type：cookie_invalid 失效 · vip_lost 会员丢失 · vip_unavailable 不能播会员曲 · app_notify_test 测试通知（10 分钟内有效）
• data.invalidCookies · data.serverTime · data.owner

点击「发送测试」查看返回（需上方测试 Token）

确认已读。同一 Token 不会再拉到这些告警。

• 请求体 JSON：{"ids":["log-id"]}

• {"success":true}

点击「发送测试」查看返回（需上方测试 Token）