Em termos de endpoints, parâmetros e respostas JSON, a Listen API v2 é quase retrocompatível com a v1 (desde maio de 2019), e os preços da v2 são mais simples.
A
Listen API v1 era alojada na RapidAPI, que tratava das análises e da faturação. Com o crescimento do Listen Notes, passámos a precisar de mais personalização e flexibilidade do que uma plataforma externa podia oferecer. Por isso, criámos a Listen API v2 para substituir a RapidAPI.
A migração para a Listen API v2 tem apenas três passos:
- Subscreva o plano FREE ou PRO nesta página.
- No código, altere o URL base para https://listen-api.listennotes.com, mude o número da versão para v2 em todos os endpoints e utilize a nova chave API no cabeçalho X-ListenAPI-Key. Pode copiar o URL completo do endpoint da página de documentação.
- Contacte hello@listennotes.com para ativarmos o modo retrocompatível. Sem ele, existem pequenas diferenças entre as respostas da v1 e da v2.
Os cabeçalhos X-RateLimit-* da v1 não existem na v2. Em alternativa, a Listen API v2 devolve X-ListenAPI-FreeQuota e X-ListenAPI-Usage.
Manteremos a Listen API v1 em funcionamento, por isso pode migrar ao seu ritmo. No entanto, todas as melhorias futuras serão exclusivas da v2.