秋天的一波新 API 上线

这几个月添加了一些 API。现介绍如下:

一言

API 名称

Hitokoto

API 说明

每次推荐一条一言。

URL

https://api.imvictor.tech/php-api/v7/hitokoto

HTTP 请求方式

GET

请求参数

charset 可选

选择文本编码，可选的编码有 UTF-8 和 GBK。若不传入该参数，则默认为 UTF-8。

请求示例

• Request URL: https://api.imvictor.tech/php-api/v7/hitokoto
• Request Method: GET

返回数据示例

• Status Code: HTTP/2.0 200

无论你在这世上的什么地方，我都一定会再去见你的

其他

“一言” 有另一个特别版本，称为“唐言”。该项目首先被用于已经停止服务的 Mountain & River Online Judge。现在该项目由 LYOI Online Judge 维护。
关于此 API 的使用，请参阅该项目的 GitHub 主页。

网易云音乐

2021 年更新：该 API 已进入停止维护阶段，建议使用 Meting API。

API 名称

CloudMusic

API 说明

本 API 内含 5 个子 API，分别是获取直链、获取高清封面、获取 LRC 主歌词、获取 LRC 副歌词(一般为翻译)、获取 LRC 完全歌词(合并翻译的主歌词)。

获取直链

付费方可试听的歌曲不支持获取直链。

歌词

对于没有歌词翻译的歌曲，LRC 完全歌词和主歌词内容相同。对于存在歌词翻译的歌曲，完全歌词会把翻译歌词合并到主歌词的时间线上。

一般的，我们推荐使用 LRC 完全歌词。

URL

获取直链: https://api.imvictor.tech/php-api/v7/cloudmusic/direct-link
获取高清封面: https://api.imvictor.tech/php-api/v7/cloudmusic/cover
获取歌词: https://api.imvictor.tech/php-api/v7/cloudmusic/lyrics

HTTP 请求方式

GET

通用请求参数

id 必需

仅需传入歌曲 ID。

歌词 API 专属请求参数

mode 可选

设置 mode 为 main 为只返回主歌词，不返回副歌词(翻译)。
设置 mode 为 sub 为只返回副歌词(翻译)，不返回主歌词。
默认为混合返回。

plain 可选

设置为 1 则返回纯文本没有时间轴的歌词，否则返回 LRC 歌词。

reverse 可选

当同时返回主歌词和副歌词时，设置 reverse 为 1 可以使副歌词在主歌词的前面。
对于 APlayer 等比较方便。

返回类型

获取直链和获取高清封面，均返回一个 302 跳转，跳转到网易官方服务器。
歌词则直接返回 UTF-8 编码的纯文本歌词。

请求示例

请求歌曲 スパークル (movie ver.) 的封面:
– Request URL: https://api.imvictor.tech/php-api/v7/cloudmusic/cover?id=426881503
– Request Method: GET

返回数据示例

• Status Code: HTTP/2.0 302
• Location: https://p1.music.126.net/sSxbRt9RpC6s_MaewyDJfA/18597139672292692.jpg

声明，该 API 完全基于网易公开 API 制作，并未涉及任何私有 API。

请大家注意，不要无节制地使用。因为服务器的资源有限，谢谢。