Wersjonowanie semantyczne. Zmiany łamiące kompatybilność (zmiana nazw pól, usunięcie endpointów, zmiana schematu uwierzytelniania) trafiają wyłącznie do nowej wersji głównej pod nowym prefiksem URL /v2/. W ramach /v1/ wprowadzane są tylko zmiany addytywne (nowe opcjonalne pola, nowe endpointy).
v1.1.0 (2026-09-23)
- POST /v1/orders: config_options przyjmuje tylko opcje i wartości widoczne w sklepie oraz ilości w ich granicach. Pominięte widoczne opcje otrzymują pierwszą wartość z listy, dokładnie tak jak w sklepie. GET /v1/products/{id} wyświetla tylko opcje, które można zamówić, i zwraca quantity.min oraz quantity.max.
- Nowy status zamówienia awaiting_setup z polem awaiting_setup dla produktów, które zespół KernelHost konfiguruje ręcznie. Usługi uruchamiane automatycznie są wdrażane dokładnie raz.
- Body żądań jest ograniczone do 64 KB (HTTP 413). Dla każdego konta obowiązuje limit 120 żądań na minutę łącznie dla wszystkich kluczy, a konto może mieć do 20 aktywnych kluczy. Nieudane uwierzytelnienie nie blokuje już żadnego klucza, a Idempotency-Key jest powiązany z metodą i ścieżką.
- Żądania z więcej niż jednym parametrem w query stringu (na przykład GET /v1/services?limit=10&offset=0) były odrzucane z kodem HTTP 401. Podpis obejmuje teraz query string dokładnie tak, jak opisano w dokumentacji.
v1.0.0 (2026-05-14)
- Pierwsze wydanie. Wszystkie 15 endpointów, uwierzytelnianie HMAC, magazyn sekretów AES-GCM, limity szybkości, idempotencja, dziennik audytu.
- GET
/v1/me,/v1/products,/v1/products/{id} - POST
/v1/orders, GET/v1/orders/{id} - GET
/v1/services,/v1/services/{id},/v1/services/{id}/credentials - POST
/v1/services/{id}/actions - GET
/v1/billing/balance,/v1/billing/invoices,/v1/billing/invoices/{id}/pdf - GET/PUT
/v1/webhooks - HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.
