🎵 音乐播放器后端 API

MP3 流式代理服务

生产环境

📋 API 文档

1. 音频流接口 (audio.php)

接口地址:

https://api.ziyic941.xyz/services/audio.php?album={album}&path={path}

请求方法: GET

参数说明:

  • album (必需): 合集名称(一级目录)
  • path (必需): MP3文件的相对路径

示例:

https://api.ziyic941.xyz/services/audio.php?album=古风&path=一花一剑.mp3

支持 Range 请求(断点续传):

Range: bytes=0-1023

2. 播放列表接口 (playlist.php)

接口地址:

https://api.ziyic941.xyz/services/playlist.php?album={album}

请求方法: GET

参数说明:

  • album (必需): 合集名称(一级目录)

示例:

https://api.ziyic941.xyz/services/playlist.php?album=古风

返回格式:

[
  {
    "name": "歌曲名称",
    "artist": "合集名称",
    "url": "音频URL",
    "pic": "",
    "lrc": ""
  }
]

说明: 此接口返回符合 nyx-player 期望格式的播放列表,用于音乐播放器初始化。

📚 更多信息

详细文档请查看 README.md 文件。

部署检查清单请查看 DEPLOYMENT_CHECKLIST.md 文件。