某易云点歌V1

# 某易云音乐点歌API文档 ## 接口简介 某易云音乐搜索+播放链接整合API，支持歌曲搜索、获取播放链接、9种音质选择。支持付费歌曲（付费专辑除外），自动整合搜索结果和播放地址。 ## 接口地址 ``` GET/POST https://your-domain.com/netease_music.php ``` ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | word | string | 条件必填 | 歌名关键词，用于搜索。有id时可不填 | | id | int | 条件必填 | 某易云音乐歌曲ID，与word二选一 | | page | int | 否 | 页码，默认1 | | num | int | 否 | 每页数量，默认10 | | choose | int | 否 | 选择第几首，0返回列表，默认0 | | quality | int | 否 | 音质1-9，默认9（超清母带）| ## 音质参数说明 | quality值 | 音质说明 | |-----------|----------| | 1 | 标准（64k）| | 2 | 标准（128k）| | 3 | HQ极高（192k）| | 4 | HQ极高（320k）| | 5 | SQ无损 | | 6 | 高解析度无损（Hi-Res）| | 7 | 高清臻音（Spatial Audio）| | 8 | 沉浸环绕声（Surround Audio）| | 9 | 超清母带（Master）| ## 请求示例 ### 按歌名搜索 ``` GET https://your-domain.com/netease_music.php?word=勾指起誓 ``` ### 指定ID获取 ``` GET https://your-domain.com/netease_music.php?id=1345872140 ``` ### 完整参数示例 ``` GET https://your-domain.com/netease_music.php?word=勾指起誓&choose=2&quality=9&page=1&num=10 ``` ### POST请求 (JSON) ```bash curl -X POST "https://your-domain.com/netease_music.php" \ -H "Content-Type: application/json" \ -d '{"word":"勾指起誓","quality":9,"choose":1}' ``` 响应参数 字段 类型 说明 code int 状态码，200为成功 message string 响应信息 data object 歌曲详细信息 data.id int 歌曲ID data.song string 歌曲名称 data.singer string 歌手名称 data.album string 专辑名称 data.time string 发行时间 data.quality string 音质描述 data.cover string 封面图片URL data.interval string 歌曲时长 data.link string 某易云音乐页面链接 data.size string 文件大小 data.kbps string 码率 data.url string 播放链接（直链） time string 响应时间 错误码说明 状态码 说明 200 请求成功 400 缺少必要参数（word和id至少填一个） 502 上游API请求失败 500 服务器内部错误

> **由 AI 生成**：本文档根据提供的配置信息自动生成，仅供参考，具体接口以实际调用为准。 ## 接口简介 某易云点歌API提供一站式音乐搜索与播放链接获取服务，支持通过歌名关键词或歌曲ID精准定位音乐资源。典型场景包括音乐播放器集成、歌单生成工具开发及音乐内容推荐系统。当前版本无需鉴权密钥，可直接调用获取付费歌曲（付费专辑除外）及9种音质（64k至超清母带）的播放链接。 ## 请求说明 - **请求地址**：`https://api.xunjinlu.fun/api/wyy/chant.php` - **HTTP方法**：`GET` / `POST` - **常用请求头**： - `Accept: application/json`（推荐） - `Content-Type: application/x-www-form-urlencoded`（POST提交时） ## 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |--------|--------|------|------| | `word` | string | 是* | 歌名关键词（与`id`二选一） | | `id` | string | 是* | 某易云音乐歌曲ID（如1345872140） | | `page` | string | 否 | 搜索结果页码（默认1） | | `num` | string | 否 | 每页显示数量（默认10） | | `choose` | string | 否 | 选择第几首歌曲（0=返回列表，默认0） | | `quality` | string | 否 | 音质等级（1-9，默认9超清母带） | > *注：`word`和`id`必须提供其中一个，但不可同时为空。 ## 返回字段表 | 字段名 | 类型 | 说明 | |----------|--------|------| | `code` | int | 状态码（200成功） | | `message`| string | 操作结果描述 | | `data` | object | 歌曲详情对象 | | `time` | string | 服务器响应时间 | **data对象字段说明**： | 字段名 | 类型 | 说明 | |----------|--------|------| | `id` | string | 歌曲ID | | `song` | string | 歌曲名称 | | `singer` | string | 歌手名 | | `album` | string | 专辑名 | | `quality`| string | 音质描述 | | `url` | string | 播放链接 | | `cover` | string | 专辑封面URL | | `size` | string | 文件大小 | | `kbps` | string | 比特率 | ## 返回JSON示例 ### 成功响应 ```json { "code": 200, "message": "请求成功！", "data": { "id": "1345872140", "song": "勾指起誓", "singer": "洛天依Official/ilem", "quality": "超清母带（Master）", "url": "http://...", "size": "65.69MB", ... }, "time": "2024-08-24 15:40:55" } ``` ### 失败响应 ```json { "code": 400, "message": "参数错误：请提供歌名或歌曲ID", "time": "2024-08-24 15:41:02" } ``` ## 错误与状态 - **HTTP状态码**： - `200`：请求成功 - `400`：参数缺失或错误 - `500`：服务器内部错误 - **业务状态码**： - `200`：成功获取数据 - `404`：歌曲不存在或已下架 - `403`：付费专辑资源受限 - **错误说明**：具体错误信息以返回的`message`字段为准。 ## 调用示例 ### 直接访问 ```text https://api.xunjinlu.fun/api/wyy/chant.php?word=勾指起誓&quality=9 ``` （浏览器访问可获取默认音质歌曲列表） ### cURL ```bash curl -X GET "https://api.xunjinlu.fun/api/wyy/chant.php?id=1345872140&quality=5" \ -H "Accept: application/json" ``` ### Python requests ```python import requests url = "https://api.xunjinlu.fun/api/wyy/chant.php" params = { "word": "晴天", "page": 1, "quality": 4 # HQ320k } response = requests.get(url, params=params) data = response.json() print(f"歌曲名: {data['data']['song']}") print(f"播放链接: {data['data']['url']}") ``` ### PHP ```php <?php $ch = curl_init(); $url = "https://api.xunjinlu.fun/api/wyy/chant.php"; $params = [ 'id' => '1345872140', 'choose' => 1, 'quality' => 9 ]; curl_setopt($ch, CURLOPT_URL, $url . '?' . http_build_query($params)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $result = curl_exec($ch); curl_close($ch); $data = json_decode($result, true); echo "歌手: " . $data['data']['singer']; ?> ``` ### HTML ```html <!-- 获取歌曲封面 --> <img src="https://api.xunjinlu.fun/api/wyy/chant.php?id=1345872140&choose=1" alt="歌曲封面"> <!-- 动态加载播放链接 --> <script src="https://api.xunjinlu.fun/api/wyy/chant.php?word=起风了&quality=7"></script> ```