就端点、参数和 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。