# Metadata
> [name=eva]

###### tags: `API`, `metadata`

---

### 後設資料簡介

- 後設資料包含 [Tracks API](https://developer.spotify.com/documentation/web-api/reference/tracks/)、[Artists API](https://developer.spotify.com/documentation/web-api/reference/artists/) 和 [Albums API](https://developer.spotify.com/documentation/web-api/reference/albums/)，可以取得歌曲、藝人和專輯的相關資訊
- 取得和指定藝人相關的藝人 (Spotify 演算法)
- 播放歌曲片段 (30s)
- 取得熱門歌曲排行
- 取得歌曲的 [ISRC 編碼](https://zh.wikipedia.org/zh-tw/%E5%9B%BD%E9%99%85%E6%A0%87%E5%87%86%E9%9F%B3%E5%83%8F%E5%88%B6%E5%93%81%E7%BC%96%E7%A0%81)
- 取得特定／使用者所在市場的資料

- Base URL: https://api.spotify.com/v1

---

#### Artists API
可以得到：
- 藝人 ([Get an Artist](https://developer.spotify.com/documentation/web-api/reference/artists/get-artist "Get an Artist"))
- 藝人的專輯 ([Get an Artist's Albums](https://developer.spotify.com/documentation/web-api/reference/artists/get-artists-albums "Get an Artist's Albums"))
- 藝人的熱門曲目 ([Get an Artist's Top Tracks](https://developer.spotify.com/documentation/web-api/reference/artists/get-artists-top-tracks "Get an Artist's Top Tracks"))
- 粉絲也喜歡 ([Get an Artist's Related Artists](https://developer.spotify.com/documentation/web-api/reference/artists/get-related-artists "Get an Artist's Related Artists"))
- 好幾個藝人 ([Get Several Artists](https://developer.spotify.com/documentation/web-api/reference/artists/get-several-artists "Get Several Artists"))

##### 藝人

`/v1/artists/{id}`

###### request
- header: `Authorization`
- path: `id`

###### response
- artist object (full)

##### 藝人的專輯

`/v1/artists/{id}/albums`

###### request
- header: `Authorization`
- path: `id`
- query: `include_groups`, `country`, `limit`, `offset` (optional)

###### response
- album object (simplified)
- paging object

##### 藝人的熱門曲目

`/v1/artists/{id}/top-tracks`

###### request
- header: `Authorization`
- path: `id`
- query: `country`

###### response
- track object (full)

##### 粉絲也喜歡

`/v1/artists/{id}/related-artists`

###### request
- header: `Authorization`
- path: `id`

###### response
- artist object (full)

##### 好幾個藝人

`/v1/artists`

###### request
- header: `Authorization`
- path: `ids`

###### response
- artist object

---

#### Albums API
可以得到：
- 專輯 ([Get an Album](https://developer.spotify.com/documentation/web-api/reference/albums/get-album/))
- 專輯的曲目 ([Get an Album's Tracks](https://developer.spotify.com/documentation/web-api/reference/albums/get-albums-tracks/))
- 好幾張專輯 ([Get several Albums](https://developer.spotify.com/documentation/web-api/reference/albums/get-several-albums/))

##### 專輯

`/v1/albums/{id}`

###### request
- header: `Authorization`
- path: `id`
- query: `market` (optional)

###### response
- album object (full)

##### 專輯的曲目

`/v1/albums/{id}/tracks`

###### request
- header: `Authorization`
- path: `id`
- query: `limit`, `offset`, `market` (optional)

###### response
- track object (simplified)
- paging object

##### 好幾張專輯

`/v1/albums`

###### request
- header: `Authorization`
- path: `id`
- query: `market` (optional)

###### response
- album object (full)

---

#### Tracks API
可以得到：
- 好幾首歌曲 ([Get Several Tracks](https://developer.spotify.com/documentation/web-api/reference/tracks/get-several-tracks "Get Several Tracks"))
- 歌曲 ([Get a Track](https://developer.spotify.com/documentation/web-api/reference/tracks/get-track "Get a Track"))

##### 好幾首歌曲

`/v1/tracks`

###### request
- header: `Authorization`
- query: `ids` (required), `market` (optional)

###### response
- track object (full)

##### 歌曲

`/v1/tracks/{id}`

###### request
- header: `Authorization`
- path: `id`
- query: `market` (optional)

###### response
- track object (full)

---

### 授權
> ref. [Authorization Guide](https://developer.spotify.com/documentation/general/guides/authorization-guide/)

- 對 Web APi 發出 request 都需要授權
- 獲得授權方式：App、使用者

---

### Spotify URIs and IDs
> ref. [Web API](https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids)

- Spotify ID: `base-62` 識別碼