某易云点歌V3

> **由 AI 生成**：本文档根据接口配置自动生成，内容仅供参考，实际调用效果以接口实时返回为准。 ## 接口简介 某易云点歌V3 提供网易云音乐无损解析服务，支持获取单曲信息、搜索歌曲、专辑及歌单数据。典型场景包括音乐播放器集成、歌词展示、音质选择等。调用时需通过 `key` 参数进行鉴权（若服务端开启密钥验证），未提供密钥将导致请求失败。 ## 请求说明 - **请求地址**：`https://api.xunjinlu.fun/apis/wymusic` - **HTTP 方法**：GET - **常用请求头**： - `Accept: application/json`（建议声明） - 鉴权参数需通过 Query String 传递：`?key=您的密钥` ## 请求参数表 | 参数 | 类型 | 必填 | 说明 | |---------|--------|------|----------------------------------------------------------------------| | key | string | 是 | 接口访问密钥（服务端开启密钥验证时必填） | | action | string | 是 | 操作类型：`song`（单曲）、`search`（搜索）、`album`（专辑）、`playlist`（歌单） | | id | string | 条件 | 歌曲/专辑/歌单ID（`action` 为 `song`/`album`/`playlist` 时必填） | | keyword | string | 条件 | 搜索关键词（`action` 为 `search` 时必填） | | level | string | 否 | 音质级别：`standard`（标准）、`exhigh`（极高）、`lossless`（无损）、`hires`（Hi-Res）、`jyeffect`（高清环绕声）、`sky`（沉浸环绕声）、`jymaster`（超清母带），默认 `lossless` | | limit | string | 否 | 搜索结果数量上限（仅 `action=search` 生效），默认 `20` | | offset | string | 否 | 搜索结果偏移量（仅 `action=search` 生效），默认 `0` | ## 返回字段表 | 字段 | 类型 | 说明 | |--------------|--------------|----------------------------------------------------------------------| | code | integer | 业务状态码：`0` 表示成功，非 `0` 表示错误 | | message | string | 状态描述（如 `success` 或错误信息） | | data | object | 响应数据主体 | | ├─ code | integer | 内部业务码（如 `200` 表示成功） | | ├─ msg | string | 内部状态描述 | | ├─ data | object | 具体业务数据 | | │ ├─ info | object | 歌曲基础信息（ID、名称、歌手、专辑、封面等） | | │ ├─ url | object | 播放链接信息（URL、音质、大小、MD5等） | | │ ├─ lyric | object | 歌词数据（包含LRC原文、翻译等） | | │ └─ ... | - | 其他结构化数据（搜索结果列表、专辑详情等） | ## 返回 JSON 示例 **成功响应（单曲）**： ```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..." } } } } ``` **失败响应**： ```json { "code": 400, "message": "缺少必要参数：action", "data": null } ``` ## 错误与状态 - **HTTP 状态码**： - `200`：请求成功 - `400`：参数错误（如缺少必填参数） - `401`：密钥无效或未授权 - `403`：访问频率超限 - `500`：服务内部错误 - **业务状态码（`data.code`）**： - `200`：操作成功 - `404`：资源未找到（如无效ID） - `503`：上游服务不可用 - **错误说明**：具体错误信息以返回字段 `message` 为准，业务错误码详见 `data.code`。 ## 调用示例 ### 直接访问 ```url https://api.xunjinlu.fun/apis/wymusic?action=song&id=1345872140&level=lossless&key=您的密钥 ``` > 在浏览器中打开此 URL 可获取单曲信息（需替换 `key` 参数）。 ### cURL ```bash curl -G "https://api.xunjinlu.fun/apis/wymusic" \ -d "action=search" \ -d "keyword=洛天依" \ -d "limit=10" \ -d "key=您的密钥" \ -H "Accept: application/json" ``` ### Python requests ```python 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 "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 ```html ```