Listen API v2 jest pod względem endpointów, parametrów i odpowiedzi JSON niemal wstecznie zgodne z v1 (stan na maj 2019 r.), a jego cennik jest prostszy.
Usługę
Listen API v1 udostępnialiśmy przez RapidAPI, które obsługiwało analitykę i rozliczenia. Wraz z rozwojem Listen Notes potrzebujemy większych możliwości dostosowania i elastyczności, niż może zaoferować zewnętrzna platforma RapidAPI. Dlatego stworzyliśmy Listen API v2, aby je zastąpić.
Migracja do Listen API v2 wymaga tylko trzech kroków:
- Wykup na tej stronie plan FREE lub PRO.
- W kodzie zmień bazowy adres URL na https://listen-api.listennotes.com, ustaw numer wersji v2 we wszystkich endpointach i użyj nowego klucza API w nagłówku X-ListenAPI-Key. Pełny adres endpointu możesz skopiować ze strony dokumentacji.
- Napisz do nas na hello@listennotes.com, abyśmy włączyli dla Ciebie tryb zgodności wstecznej. Bez niego odpowiedzi API w v1 i v2 nieznacznie się różnią.
Nagłówki odpowiedzi X-RateLimit-* z Listen API v1 nie występują w v2. Zamiast nich Listen API v2 zwraca nagłówki X-ListenAPI-FreeQuota i X-ListenAPI-Usage.
Listen API v1 pozostanie dostępne, więc możesz spokojnie zaplanować migrację. Wszystkie przyszłe ulepszenia będą jednak wprowadzane wyłącznie w Listen API v2.