13-monster-siren

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

エンドポイント一覧

ベース URL

https://monster-siren.hypergryph.com

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

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

GET /api/albums

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

必須パラメーター

なし

レスポンス例

/api/albums

1
{
2
   "code":0,
3
   "msg":"",
4
   "data":[
5
      {
6
         "cid":"7783",
7
         "name":"Ensheath",
8
         "coverUrl":"https://web.hycdn.cn/siren/pic/20220907/f4fbe128f184c617df3c597bcefb6687.jpg",
9
         "artistes":[
10
            "塞壬唱片-MSR"
11
         ]
12
      },
13
      {
14
         "cid":"9397",
15
         "name":"危机合约尘环行动OST",
16
         "coverUrl":"https://web.hycdn.cn/siren/pic/20220826/5dff26633eccf4654a47098f0f45387f.jpg",
17
         "artistes":[
18
            "塞壬唱片-MSR"
19
         ]
20
      },
21
      ...[略]...
22
      {
23
         "cid":"4527",
24
         "name":"明日方舟OST1",
25
         "coverUrl":"https://web.hycdn.cn/siren/pic/20210322/bb51040a1dfe53b97590451156852bd6.jpg",
26
         "artistes":[
27
            "塞壬唱片-MSR"
28
         ]
29
      }
30
   ]
31
}

レスポンスパラメーター

名前	型	説明
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

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

レスポンスパラメーター

名前	型	説明
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

1
{
2
   "code":0,
3
   "msg":"",
4
   "data":{
5
      "cid":"9397",
6
      "name":"危机合约尘环行动OST",
7
      "intro":"寄身锋刃，首丘蒙尘。\n疮痍遍地，何以止息？",
8
      "belong":"arknights",
9
      "coverUrl":"https://web.hycdn.cn/siren/pic/20220826/5dff26633eccf4654a47098f0f45387f.jpg",
10
      "coverDeUrl":"https://web.hycdn.cn/siren/pic/20220826/85edbb18ec55fd43d2a65d235d626c2d.jpg",
11
      "songs":[
12
         {
13
            "cid":"306837",
14
            "name":"Operation Ashring",
15
            "artistes":[
16
               "塞壬唱片-MSR"
17
            ]
18
         },
19
         {
20
            "cid":"880358",
21
            "name":"Operation Ashring（Instrumental）",
22
            "artistes":[
23
               "塞壬唱片-MSR"
24
            ]
25
         },
26
         {
27
            "cid":"514566",
28
            "name":"Crawling Forward!",
29
            "artistes":[
30
               "塞壬唱片-MSR"
31
            ]
32
         }
33
      ]
34
   }
35
}

レスポンスパラメーター

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

GET /api/songs

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

必須パラメーター

なし

レスポンス例

/api/songs

1
{
2
   "code":0,
3
   "msg":"",
4
   "data":{
5
      "list":[
6
         {
7
            "cid":"514565",
8
            "name":"Ensheath (Instrumental)",
9
            "albumCid":"7783",
10
            "artists":[
11
               "塞壬唱片-MSR"
12
            ]
13
         },
14
         {
15
            "cid":"461173",
16
            "name":"Ensheath",
17
            "albumCid":"7783",
18
            "artists":[
19
               "塞壬唱片-MSR"
20
            ]
21
         },
22
        ...[省略]...
23
      ],
24
      "autoplay":null
25
   }
26
}

レスポンスパラメーター

名前	型	説明
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

1
{
2
   "code":0,
3
   "msg":"",
4
   "data":{
5
      "cid":"306837",
6
      "name":"Operation Ashring",
7
      "albumCid":"9397",
8
      "sourceUrl":"https://res01.hycdn.cn/a6e7ee185aaee32afb46ab3a0ec5bcc5/6320090A/siren/audio/20220826/3a988360ff0c0fb07478e2f9bfcebcd4.wav",
9
      "lyricUrl":"https://web.hycdn.cn/siren/lyric/20220826/13eb91a3033439862e89a128da629fb2.lrc",
10
      "mvUrl":null,
11
      "mvCoverUrl":null,
12
      "artists":[
13
         "塞壬唱片-MSR"
14
      ]
15
   }
16
}

レスポンスパラメーター

名前	型	説明
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` のみだが稀に複数入る

License under CC BY 4.0 https://creativecommons.org/licenses/by/4.0/deed.ja

Monster Siren の​ API リファレンス

Monster Siren の API リファレンス