Meting_kugou当サイトではサービスを提供しておりません。以下はあくまでリポジトリのデモ例です。
1. 基本アドレス
- メインアドレス：
https://api.kfjie.me/music - リクエスト方法：
GET - 用途 ：MetingJS、APlayer、およびサイト内のカスタムプレーヤーに対して、統一されたデータインターフェースを提供する
2. よく使われるパラメータ
インターフェースで最もよく使われる3つのパラメータは以下の通りです：
| パラメータ | 説明 |
|---|---|
server | プラットフォーム、例えば netease、tencent、kugou |
type | 操作の種類、例えば search、song、playlist、album |
id | 対応するプラットフォームのリソースID、キーワード、ハッシュ、またはKuGouデスクトッププレイリストの共有ショートコード／リンク |
よくある type：
type | 作用 | 戻る |
|---|---|---|
search | 曲を検索 | JSON 配列 |
song | シングルの詳細を表示する | JSON 配列 |
playlist | プレイリスト一覧を取得する | JSON 配列 |
album | アルバムの楽曲を取得する | JSON 配列 |
artist | 歌手の人気曲を検索する | JSON 配列 |
url | 再生URLを取得する | 302 / 404 |
pic | 表紙のURLを取得する | 302 |
lrc | 歌詞を取得する | テキスト |
3. 結果の形式はどのようなものか
search / song / album / artist / playlist 通常、JSON 配列を返します：
[
{
"title": "歌曲名称",
"author": "艺术家1 / 艺术家2",
"url": "https://api.kfjie.me/music?server=kugou&type=url&id=xxx&auth=xxx",
"pic": "https://api.kfjie.me/music?server=kugou&type=pic&id=xxx&auth=xxx",
"lrc": "https://api.kfjie.me/music?server=kugou&type=lrc&id=xxx&auth=xxx"
}
]
url / pic 直接 302 リダイレクトにより実際のリソースへ転送されます；lrc 歌詞テキストを返す。実際の導入においては、通常、これらのサブリンクを手動で組み立てる必要はなく、プレーヤーが直接処理する。 song / album 結果に含まれる既存のフィールドなど。
4. について auth key
url / pic / lrc この種の機密性の高いリソースには、 auth。通常のアクセス時には、手動で計算する必要はなく、APIが返す既成のリンクをそのまま使用すればよい。
もし、サーバーから割り当てられた key、リクエストに添付することも可能です key=... 直接「KuGou Pro」プールを利用し、対応する分単位の利用枠の範囲内で引き続きアクセスする url / pic / lrc、このような場面では、わざわざ文字を組み合わせる必要はもうありません auth。
5. 一般的な接続方法
シナリオ A：フロントエンド連携（MetingJS）
統一APIのURLを当サイトのAPIエンドポイントに設定するだけで済みます：
<!-- 设定接口主轴引擎 -->
<script>
var meting_api = 'https://api.kfjie.me/music?server=:server&type=:type&id=:id&auth=:auth&r=:r';
</script>
<!-- 调用指定参数渲染音乐卡片 -->
<meting-js server="netease" type="song" id="29732235"></meting-js>
シナリオ B：簡易テスト
以下の方法で、正常に動作しているかどうかを簡単に確認できます：
曲の詳細情報を取得する：
curl "https://api.kfjie.me/music?server=kugou&type=song&id=d0ee43db52939cb9feefa4513573ffb4"
特定のアーティストのコンテンツを検索する：
curl "https://api.kfjie.me/music?server=kugou&type=search&id=邓紫棋"
KuGouデスクトップでプレイリストを共有する：
curl "https://api.kfjie.me/music?server=kugou&type=playlist&id=7PUvhf0FZV2"
6. 使用上のアドバイス
- プレーヤーが必要な場合は、優先して
song/playlist/album返された既製のものurl、pic、lrc - トラブルシューティングが必要な場合は、まず測定を行ってください
searchまたはsong、続いて、プレーヤーが返された結果を正常に処理できるかどうかを確認する - Kugouデスクトッププレイリストの共有については、ショートコードを優先して送信するか、または
t1.kugou.com短いリンクを使用し、署名付きパラメータを含む長いリンクへの直接依存を避ける - KuGouのシナリオでは、実行時にはアルバムの展開に依存するのではなく、楽曲のハッシュを直接使用することをお勧めします。
- 現在、Kugouのプレイリストはデスクトップ版KUGOUの共有リンクを利用して、Kugouのすべてのプレイリストの詳細情報を取得できます。標準的な方法の使用をお勧めします。
type=playlist、そしてid伝成が短縮URLや短縮リンクを共有する場合、例えば7PUvhf0FZV2またはhttps://t1.kugou.com/7PUvhf0FZV2。 - モバイル版の共有リンクは、現在解析できません。
クーゴーのコードを使えばいいのかな？でも、すごく面倒くさいし、もうやりたくないな。誰か既成のものをくれないかな？
