首页 全部接口 API文档 文章 贡献者 友链 赞助 关于
登录/注册

某易云点歌V3

GET https://apis.whrx.chat/apis/wymusic
由 AI 生成:本文档根据接口配置自动生成,内容仅供参考,实际调用效果以接口实时返回为准。

接口简介

某易云点歌V3 提供网易云音乐无损解析服务,支持获取单曲信息、搜索歌曲、专辑及歌单数据。典型场景包括音乐播放器集成、歌词展示、音质选择等。调用时需通过 key 参数进行鉴权(若服务端开启密钥验证),未提供密钥将导致请求失败。

请求说明

  • 请求地址https://api.xunjinlu.fun/apis/wymusic
  • HTTP 方法:GET
  • 常用请求头
- Accept: application/json(建议声明) - 鉴权参数需通过 Query String 传递:?key=您的密钥

请求参数表

参数类型必填说明
keystring接口访问密钥(服务端开启密钥验证时必填)
actionstring操作类型:<code>song</code>(单曲)、<code>search</code>(搜索)、<code>album</code>(专辑)、<code>playlist</code>(歌单)
idstring条件歌曲/专辑/歌单ID(<code>action</code> 为 <code>song</code>/<code>album</code>/<code>playlist</code> 时必填)
keywordstring条件搜索关键词(<code>action</code> 为 <code>search</code> 时必填)
levelstring音质级别:<code>standard</code>(标准)、<code>exhigh</code>(极高)、<code>lossless</code>(无损)、<code>hires</code>(Hi-Res)、<code>jyeffect</code>(高清环绕声)、<code>sky</code>(沉浸环绕声)、<code>jymaster</code>(超清母带),默认 <code>lossless</code>
limitstring搜索结果数量上限(仅 <code>action=search</code> 生效),默认 <code>20</code>
offsetstring搜索结果偏移量(仅 <code>action=search</code> 生效),默认 <code>0</code>

返回字段表

字段类型说明
codeinteger业务状态码:<code>0</code> 表示成功,非 <code>0</code> 表示错误
messagestring状态描述(如 <code>success</code> 或错误信息)
dataobject响应数据主体
├─ codeinteger内部业务码(如 <code>200</code> 表示成功)
├─ msgstring内部状态描述
├─ dataobject具体业务数据
│ ├─ infoobject歌曲基础信息(ID、名称、歌手、专辑、封面等)
│ ├─ urlobject播放链接信息(URL、音质、大小、MD5等)
│ ├─ lyricobject歌词数据(包含LRC原文、翻译等)
│ └─ ...-其他结构化数据(搜索结果列表、专辑详情等)

返回 JSON 示例

成功响应(单曲)
{
  "code": 0,
  "message": "success",
  "data": {
    "code": 200,
    "msg": "获取成功",
    "data": {
      "info": {
        "id": 1345872140,
        "name": "勾指起誓",
        "singer": "洛天依Official/ilem",
        "picimg": "https://p1.music.126.net/...",
        "duration": "3:04"
      },
      "url": {
        "url": "https://m701.music.126.net/...",
        "level": "lossless",
        "size": 21947098
      },
      "lyric": {
        "lrc": "[00:00.000] 作词 : ilem\n..."
      }
    }
  }
}

失败响应

{
"code": 400,
"message": "缺少必要参数:action",
"data": null
}

错误与状态

  • HTTP 状态码
- 200:请求成功 - 400:参数错误(如缺少必填参数) - 401:密钥无效或未授权 - 403:访问频率超限 - 500:服务内部错误
  • 业务状态码(data.code
- 200:操作成功 - 404:资源未找到(如无效ID) - 503:上游服务不可用
  • 错误说明:具体错误信息以返回字段 message 为准,业务错误码详见 data.code

调用示例

直接访问

https://api.xunjinlu.fun/apis/wymusic?action=song&id=1345872140&level=lossless&key=您的密钥
在浏览器中打开此 URL 可获取单曲信息(需替换 key 参数)。

cURL

curl -G "https://api.xunjinlu.fun/apis/wymusic" \
  -d "action=search" \
  -d "keyword=洛天依" \
  -d "limit=10" \
  -d "key=您的密钥" \
  -H "Accept: application/json"

Python requests

import requests

url = "https://api.xunjinlu.fun/apis/wymusic"
params = {
"action": "song",
"id": "1345872140",
"level": "lossless",
"key": "您的密钥"
}

response = requests.get(url, params=params)
data = response.json()
print(data["data"]["data"]["info"]["name"])

PHP

<?php
$url = "https://api.xunjinlu.fun/apis/wymusic";
$params = [
    "action" => "playlist",
    "id" => "746123405",
    "key" => "您的密钥"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Accept: application/json"]);

$result = curl_exec($ch);
curl_close($ch);

$data = json_decode($result, true);
echo $data["data"]["msg"];
?>

HTML

歌曲封面