Registro de Alterações da API

Todas as respostas v1 incluem agora o cabeçalho X-API-Version: 1.0.0. Os clientes podem usar este cabeçalho para verificar qual versão da API respondeu e implementar lógica sensível à versão nas suas integrações.

Os endpoints podem agora sinalizar descontinuação através de cabeçalhos Deprecation, Sunset e Link conformes com RFC 8594. Quando um endpoint está agendado para remoção, o cabeçalho Deprecation indica a data de descontinuação, o cabeçalho Sunset sinaliza a data de remoção e o cabeçalho Link aponta para a documentação do endpoint substituto.

Todas as respostas de erro agora retornam um formato consistente { ok: false, error, code?, status }. O formato legado { error } está obsoleto e será removido em uma versão futura. As respostas de sucesso continuam retornando { ok: true, data, ... }. Essa unificação simplifica o tratamento de erros no lado do cliente em todos os 83 endpoints.

Lançamos a API para desenvolvedores do akousa.net com 83 endpoints em 17 grupos, uma especificação OpenAPI 3.1 completa, acesso à API incluído no Akousa Pro, autenticação por chave de API usando o prefixo ak_ e limitação de taxa com cotas diárias por nível. Documentação interativa com exemplos de código em 8 linguagens (cURL, JavaScript, Python, Go, PHP, Ruby, Java, C#).