Plat profile icon

Plat Dev

🎵

Monster Siren の API リファレンス

アークナイツ

目次 (クリックで展開)

アークナイツの OST を聴くことができる Monster Siren のサイト。
API が認証不要で使えるので、そのエンドポイントとレスポンスをメモっておく。

エンドポイント一覧

ベース URL

https://monster-siren.hypergryph.com

共通レスポンスパラメーター

名前 型 説明
code number 正常なら 0
msg string エラーの場合にエラーメッセージが入る
data any 目当てのデータ。配列の時もあればオブジェクトの時もある

GET /api/albums

全てのアルバムを取得します。

必須パラメーター

なし

レスポンス例

/api/albums

{
   "code":0,
   "msg":"",
   "data":[
      {
         "cid":"7783",
         "name":"Ensheath",
         "coverUrl":"https://web.hycdn.cn/siren/pic/20220907/f4fbe128f184c617df3c597bcefb6687.jpg",
         "artistes":[
            "塞壬唱片-MSR"
         ]
      },
      {
         "cid":"9397",
         "name":"危机合约尘环行动OST",
         "coverUrl":"https://web.hycdn.cn/siren/pic/20220826/5dff26633eccf4654a47098f0f45387f.jpg",
         "artistes":[
            "塞壬唱片-MSR"
         ]
      },
      ...[略]...
      {
         "cid":"4527",
         "name":"明日方舟OST1",
         "coverUrl":"https://web.hycdn.cn/siren/pic/20210322/bb51040a1dfe53b97590451156852bd6.jpg",
         "artistes":[
            "塞壬唱片-MSR"
         ]
      }
   ]
}

レスポンスパラメーター

名前 型 説明
cid string アルバムの ID
name string アルバム名
coverUrl string アルバムジャケット画像の URL
artistes string アーティスト一覧。artists ではなく artistes なことに注意

GET /api/album/:albumId/data

アルバムの情報を取得します

必須パラメーター

名前 説明
albumId アルバムのID。/api/albums で取得できる cid と同一

レスポンス例

/api/album/9397/data

{
   "code":0,
   "msg":"",
   "data":{
      "cid":"9397",
      "name":"危机合约尘环行动OST",
      "intro":"寄身锋刃，首丘蒙尘。\n疮痍遍地，何以止息？",
      "belong":"arknights",
      "coverUrl":"https://web.hycdn.cn/siren/pic/20220826/5dff26633eccf4654a47098f0f45387f.jpg",
      "coverDeUrl":"https://web.hycdn.cn/siren/pic/20220826/85edbb18ec55fd43d2a65d235d626c2d.jpg",
      "artistes":[
         "塞壬唱片-MSR"
      ]
   }
}

レスポンスパラメーター

名前 型 説明
cid string アルバムの ID
name string アルバム名
intro string アルバムの説明
belong string 今は全て arknights だが、今後増える可能性あり
coverUrl string アルバムジャケット画像の URL
coverDeUrl string バナー画像。アルバムジャケットと同じものが使われる場合もある。
artistes string アーティスト一覧。artists ではなく artistes なことに注意

GET /api/album/:albumId/detail

アルバムの詳細を取得します。/api/album/:albumId/data との差異は、/api/album/:albumId/detail の方はアルバムに含まれる曲の情報も返ってくる代わりにレスポンスが少し遅いです。

必須パラメーター

名前 説明
albumId アルバムのID。/api/albums で取得できる cid と同一

レスポンス例

/api/album/9397/detail

{
   "code":0,
   "msg":"",
   "data":{
      "cid":"9397",
      "name":"危机合约尘环行动OST",
      "intro":"寄身锋刃，首丘蒙尘。\n疮痍遍地，何以止息？",
      "belong":"arknights",
      "coverUrl":"https://web.hycdn.cn/siren/pic/20220826/5dff26633eccf4654a47098f0f45387f.jpg",
      "coverDeUrl":"https://web.hycdn.cn/siren/pic/20220826/85edbb18ec55fd43d2a65d235d626c2d.jpg",
      "songs":[
         {
            "cid":"306837",
            "name":"Operation Ashring",
            "artistes":[
               "塞壬唱片-MSR"
            ]
         },
         {
            "cid":"880358",
            "name":"Operation Ashring（Instrumental）",
            "artistes":[
               "塞壬唱片-MSR"
            ]
         },
         {
            "cid":"514566",
            "name":"Crawling Forward!",
            "artistes":[
               "塞壬唱片-MSR"
            ]
         }
      ]
   }
}

レスポンスパラメーター

名前 型 説明
cid string 曲の ID
name string 曲名
artistes string アーティスト一覧。artists ではなく artistes なことに注意

GET /api/songs

全ての曲の情報を取得します。音源 URL やカバー画像は付属しません。

必須パラメーター

なし

レスポンス例

/api/songs

{
   "code":0,
   "msg":"",
   "data":{
      "list":[
         {
            "cid":"514565",
            "name":"Ensheath (Instrumental)",
            "albumCid":"7783",
            "artists":[
               "塞壬唱片-MSR"
            ]
         },
         {
            "cid":"461173",
            "name":"Ensheath",
            "albumCid":"7783",
            "artists":[
               "塞壬唱片-MSR"
            ]
         },
        ...[省略]...
      ],
      "autoplay":null
   }
}

レスポンスパラメーター

名前 型 説明
cid string 曲の ID
name string 曲名
albumCid string アルバムの ID
artists string アーティスト一覧。ここだけなぜか artists なのに注意
autoplay boolean? おそらく Web クライアントの自動再生のフラグ

GET /api/song/:songId

曲の詳細を取得します

必須パラメーター

名前 説明
songId 曲のID。/api/songs で取得できる list.cid、 /api/album/:albumId/detail で取得できる songs.cid と同一

レスポンス例

/api/song/306837

{
   "code":0,
   "msg":"",
   "data":{
      "cid":"306837",
      "name":"Operation Ashring",
      "albumCid":"9397",
      "sourceUrl":"https://res01.hycdn.cn/a6e7ee185aaee32afb46ab3a0ec5bcc5/6320090A/siren/audio/20220826/3a988360ff0c0fb07478e2f9bfcebcd4.wav",
      "lyricUrl":"https://web.hycdn.cn/siren/lyric/20220826/13eb91a3033439862e89a128da629fb2.lrc",
      "mvUrl":null,
      "mvCoverUrl":null,
      "artists":[
         "塞壬唱片-MSR"
      ]
   }
}

レスポンスパラメーター

名前 型 説明
cid string 曲のID
name string 曲名
albumCid string 曲が含まれるアルバムのID
sourceUrl string 音源のURL。一定時間で更新される
lyricUrl string? 歌詞ファイルのURL。歌詞のない曲は null。形式は .lrc
mvUrl null おそらく MV の URL だがここに値が入っていたことは一度もない
mvCoverUrl null MV に関連する URL だが値が入っていたことは一度もない
artists string[] アーティストの一覧。ほぼ 塞壬唱片-MSR のみだが稀に複数入る

Plat#6137

@p1atdev

© Plat 2022

Source