2019年5月時点で、Listen API v2はendpoint、parameter、JSON responseについてv1とほぼ後方互換です。v2の料金体系はより単純です。
v1はanalyticsとbillingを処理する
RapidAPI上で提供していました。事業拡大に伴い、より自由なcustomizationが必要になったためv2を構築しました。
移行手順:
- このページでFREEまたはPROプランを契約します。
- base URLをhttps://listen-api.listennotes.comにし、endpointのversionをv2に変更し、X-ListenAPI-Key headerに新しいAPI keyを設定します。完全なURLはdocsからコピーできます。
- hello@listennotes.comへ連絡し、後方互換モードを有効にします。未設定だとresponseに小さな違いがあります。
v1のX-RateLimit-* headerはv2にはありません。代わりにX-ListenAPI-FreeQuotaとX-ListenAPI-Usageがあります。
v1も引き続き稼働します。急いで移行する必要はありませんが、今後の改善はv2のみです。