Changelog API

Všechny odpovědi v1 nyní obsahují hlavičku X-API-Version: 1.0.0. Klienti mohou tuto hlavičku použít k ověření verze API, která obsluhovala požadavek, a k implementaci logiky závislé na verzi.

Endpointy nyní mohou signalizovat deprecaci pomocí hlaviček Deprecation, Sunset a Link kompatibilních s RFC 8594. Když je endpoint naplánován k odstranění, hlavička Deprecation udává datum deprecace, Sunset datum odstranění a Link odkazuje na dokumentaci náhradního endpointu.

Všechny chybové odpovědi nyní vracejí konzistentní strukturu { ok: false, error, code?, status }. Starší struktura { error } je zastaralá a bude v budoucí verzi odstraněna. Úspěšné odpovědi nadále vracejí { ok: true, data, ... }. Toto sjednocení zjednodušuje zpracování chyb na straně klienta napříč všemi 83 koncovými body.

Spuštěno vývojářské API akousa.net s 83 koncovými body napříč 17 skupinami, kompletní specifikací OpenAPI 3.1, přístupem k API zahrnutým v Akousa Pro, ověřováním API klíčem pomocí prefixu ak_ a omezením rychlosti s denními kvótami podle úrovně. Interaktivní dokumentace s příklady kódu v 8 jazycích (cURL, JavaScript, Python, Go, PHP, Ruby, Java, C#).