X-API-Version-header
Alle v1-antwoorden bevatten nu de header X-API-Version: 1.0.0. Clients kunnen deze header gebruiken om te controleren welke API-versie het antwoord heeft gegeven en om versie-bewuste logica in hun integraties te implementeren.
Een chronologisch overzicht van wijzigingen, verbeteringen en nieuwe functies in de akousa.net Developer API.
Alle v1-antwoorden bevatten nu de header X-API-Version: 1.0.0. Clients kunnen deze header gebruiken om te controleren welke API-versie het antwoord heeft gegeven en om versie-bewuste logica in hun integraties te implementeren.
Eindpunten kunnen nu veroudering aangeven via RFC 8594-conforme Deprecation-, Sunset- en Link-headers. Wanneer een eindpunt gepland is voor verwijdering, geeft de Deprecation-header de verouderingsdatum aan, signaleert de Sunset-header de verwijderingsdatum en verwijst de Link-header naar de documentatie van het vervangende eindpunt.
Alle foutresponsen retourneren nu een consistente { ok: false, error, code?, status }-vorm. De verouderde { error }-vorm is afgeschaft en wordt in een toekomstige versie verwijderd. Succesresponsen blijven { ok: true, data, ... } retourneren. Deze unificatie vereenvoudigt de foutafhandeling aan de clientzijde over alle 83 endpoints.
De akousa.net Developer API gelanceerd met 83 endpoints over 17 groepen, een complete OpenAPI 3.1-specificatie, API-toegang inbegrepen bij Akousa Pro, API-sleutelauthenticatie met het ak_ prefix, en rate limiting met dagelijkse quota per niveau. Interactieve documentatie met codevoorbeelden in 8 talen (cURL, JavaScript, Python, Go, PHP, Ruby, Java, C#).