解決問題 Spotify Web API (1)

教學目標

主要解決使用 Spotify Web API 取得資料的問題。

重點概念

首先透過 Spotify Web API 能夠讓我們的應用程式進行下述三件事情,分別為:

  1. 從 Spotify 音樂目中取得資料。
  2. 管理使用者播放清單。
  3. 儲存音樂。

接著藉由 REST 簡單原則,Web API 端點主要會回傳來自 Spotify 目中有關歌手、專輯和曲目 JSON 格式的中繼資料。同時 API 也提供存取使用者相關的資料,像是播放清單和儲存音樂庫,請注意使用者必須授權才能夠取得。

再來開啟 Spotify Web API Console 網站則能夠讓我們透過簡單的使用介面進行操作,主要有五個步驟,分別為:

  1. 選擇 Web API 的操作。
  2. 按下「GET OAUTH TOKEN」,取得 OAuth Token 。
  3. 勾選特別的授權範圍,並且按下「REQUEST TOKEN」,設定針對該 Web API 特別的授權範圍。
  4. 根據不同 Web API 的操作輸入適當的參數,或者按下「FILL SAMPLE DATA」填入範例參數。
  5. 按下「TRY IT」,我們就能夠取得 Web API 回傳的 JSON 資料。

最後我們也可以透過畫面中的「cURL Command」的 curl 指令操作 Web API 搭配 OAuth Token 取得適當的資料,請參考下述指令,請注意其中 OAuth Token 請更換為新產生的 OAuth Token 才能夠正常使用,否則會有「401 Invalid access token」的錯誤訊息,此外若是 Windows 平台可以下載 curl 工具進行操作。

1
curl -X GET "https://api.spotify.com/v1/search?q=Muse&type=track,artist&market=US" -H "Accept: application/json" -H "Authorization: Bearer [OAuth Token]"

總結 Spotify Web API 提供簡易操作的線上網站能夠讓我們輕易的進行操作,至於關鍵則是取得 OAuth Token 才能夠正常使用 Spotify Web API 。當然 Spotify Web API 也提供了許多不同程式碼的範例和函式庫供我們參考,主要實作會分成兩個階段,分別為註冊應用程式並且取得 OAuth Token,以及透過 Web API 取得資料,至於如何開始使用請參考官方文件。

相關資源