就端點、參數和 JSON 回應而言,Listen API v2(截至 2019 年 5 月)幾乎向後相容 v1,而且 v2 的定價更簡單。
我們曾將
Listen API v1 託管在 RapidAPI 上,由 RapidAPI 為我們處理分析和計費。隨著 Listen Notes 業務的發展,我們需要比第三方平台 RapidAPI 所能提供的更強客製化能力和靈活性。因此,我們建置了 Listen API v2 來取代 RapidAPI。
遷移到 Listen API v2 只需三個步驟:
- 訂閱本頁的 FREE 或 PRO 方案。
- 在程式碼中將基礎 URL 改為 https://listen-api.listennotes.com,把所有端點的版本號改為 v2,並在 X-ListenAPI-Key 請求標頭中使用新的 API 金鑰。您可以直接從說明檔案頁面複製完整的端點 URL。
- 透過 hello@listennotes.com 聯絡我們,以便我們為您啟用「向後相容」模式。否則,v1 和 v2 的 API 回應會有少量差異。
Listen API v1 的 X-RateLimit-* 回應標頭在 v2 中不再存在。使用 Listen API v2 時,請改用 X-ListenAPI-FreeQuota 和 X-ListenAPI-Usage 回應標頭。
我們會繼續執行 Listen API v1,您可以從容遷移到 v2。今後的所有改進將只 套用於 Listen API v2。