Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arrow2nd/imas-artwork-api
💿 アイマス CD の非公式アートワーク情報 API
https://github.com/arrow2nd/imas-artwork-api
api artworks idolmaster
Last synced: 11 days ago
JSON representation
💿 アイマス CD の非公式アートワーク情報 API
- Host: GitHub
- URL: https://github.com/arrow2nd/imas-artwork-api
- Owner: arrow2nd
- License: mit
- Created: 2022-04-01T04:39:42.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-10T12:08:56.000Z (about 2 months ago)
- Last Synced: 2024-10-15T07:24:46.392Z (24 days ago)
- Topics: api, artworks, idolmaster
- Language: TypeScript
- Homepage:
- Size: 272 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# imas-artwork-api
アイマス CD の非公式アートワーク情報 API
## エンドポイント
`https://imas-artwork-api.deno.dev/v1/`
### GET /cd/:id
CD の ID (品番) からアートワークを取得
#### パスパラメータ
| 名前 | 型 | 内容 |
| ---- | ------ | --------------- |
| id | string | CD の ID (品番) |
#### レスポンス
| 名前 | 型 | 内容 |
| ------- | ------ | -------------------- |
| id | string | CD の ID(品番) |
| title | string | タイトル |
| website | string | CD の詳細ページ URL |
| image | string | アートワーク画像 URL |
#### 例
リクエスト
```sh
curl "https://imas-artwork-api.deno.dev/v1/cd/LACA-15905"
```
レスポンス
```json
{
"id": "LACA-15905",
"title": "THE IDOLM@STER MILLION LIVE! M@STER SPARKLE2 05",
"website": "https://www.lantis.jp/imas/release_SPARKLE2_05.html",
"image": "https://www.lantis.jp/imas/img/LACA-15905_H1.jpg"
}
```
### GET /list
キーワードからアートワークを一覧で取得
#### クエリパラメータ
| 名前 | 型 | 内容 | 必須か |
| ------- | --------------- | -------------- | ------ |
| keyword | string | 検索キーワード | 必須 |
| order | "id" \| "title" | ソート基準 | 任意 |
| orderby | "asc" \| "desc" | ソート順 | 任意 |
| limit | number | 取得件数 | 任意 |
- `order` 及び `orderby` を指定しない場合は順不同となります。
#### レスポンス (配列)
| 名前 | 型 | 内容 |
| ------- | ------ | -------------------- |
| id | string | CD の ID(品番) |
| title | string | タイトル |
| website | string | CD の詳細ページ URL |
| image | string | アートワーク画像 URL |
#### 例
リクエスト
```sh
curl "https://imas-artwork-api.deno.dev/v1/list?keyword=%E7%99%BD%E8%8F%8A%E3%81%BB%E3%81%9F%E3%82%8B&order=id&orderby=asc"
```
レスポンス
```json
[
{
"id": "COCC-17628",
"title": "THE IDOLM@STER CINDERELLA MASTER 052 白菊ほたる",
"website": "https://columbia.jp/idolmaster/COCC-17628.html",
"image": "https://columbia.jp/idolmaster/img/COCC-17628.jpg"
}
]
```