Dziennik zmian API

Wszystkie odpowiedzi v1 zawierają teraz nagłówek X-API-Version: 1.0.0. Klienci mogą używać tego nagłówka do weryfikacji wersji API, która obsłużyła żądanie, oraz implementacji logiki zależnej od wersji.

Endpointy mogą teraz sygnalizować deprecację za pomocą zgodnych z RFC 8594 nagłówków Deprecation, Sunset i Link. Gdy endpoint jest zaplanowany do usunięcia, nagłówek Deprecation wskazuje datę deprecacji, Sunset — datę usunięcia, a Link odsyła do dokumentacji zastępczego endpointu.

Wszystkie odpowiedzi z błędami zwracają teraz spójny kształt { ok: false, error, code?, status }. Starszy kształt { error } jest przestarzały i zostanie usunięty w przyszłej wersji. Pomyślne odpowiedzi nadal zwracają { ok: true, data, ... }. To ujednolicenie upraszcza obsługę błędów po stronie klienta we wszystkich 83 punktach końcowych.

Uruchomiono API dla deweloperów akousa.net z 83 punktami końcowymi w 17 grupach, kompletną specyfikacją OpenAPI 3.1, dostępem do API zawartym w Akousa Pro, uwierzytelnianiem za pomocą klucza API z prefiksem ak_ oraz ograniczaniem szybkości z dziennymi przydziałami zależnymi od poziomu. Interaktywna dokumentacja z przykładami kodu w 8 językach (cURL, JavaScript, Python, Go, PHP, Ruby, Java, C#).