Szemantikus verziókezelés. Töréses változások (mezők átnevezése, végpontok eltávolítása, hitelesítési séma módosítása) kizárólag új főverzióban érkeznek új URL-előtag alatt: /v2/. A /v1/ keretein belül kizárólag additív változások történnek (új opcionális mezők, új végpontok).
v1.4.0 (2026-11-09)
- Új útvonal: GET /v1/services/{id}/metrics (read:services jogosultság), szervermérések az 1h, 6h, 24h, 7d és 14d időtartamra. Az Edge Unlimited Traffic VPS szerverek CPU-, memória-, hálózati és kimenőforgalmi adatokat adnak, a hagyományos Unlimited Traffic VPS szerverek pedig a végpont-referenciában felsorolt helyszíneken bejövő és kimenő hálózati forgalmat.
- Új útvonalak: GET /v1/services/{id}/ddos/attacks és GET /v1/services/{id}/ddos/attacks/{attack_id} (read:ddos jogosultság), támadási jelentések a Remote DDoS Protection szolgáltatáshoz legfeljebb 90 napra visszamenőleg, forgalmi görbével és protokoll, port, forrás és csomagméret szerinti bontással.
- Profilok és szabályok (/ddos/profiles, /ddos/rules és az írási műveletek): ha a szolgáltatás az Ön fiókjához tartozik, de nem Advanced DDoS Protection szolgáltatás, a válasz mostantól HTTP 404 helyett HTTP 409 not_supported_for_product. Ismeretlen vagy idegen szolgáltatásazonosítók esetén továbbra is HTTP 404 a válasz.
v1.3.1 (2026-11-02)
- Németország és Franciaország külön is választható: a „Németország (Európa)” kizárólag németországi, frankfurti, a „Franciaország (Európa)” pedig kizárólag franciaországi elhelyezést jelent.
- A hagyományos Unlimited Traffic VPS szerverek átadása az Európa, Németország, Franciaország, Kelet-Kanada, Egyesült Királyság és Lengyelország helyszíneken akár 7 napot is igénybe vehet. A szerver a legtöbb esetben 48 órán belül elkészül. A kifizetett időszak csak a szerver átadásakor kezdődik.
v1.3.0 (2026-11-02)
- Advanced DDoS Protection: profilok és szabályok lekérése, szabályok hozzáadása és saját szabályok törlése négy új útvonalon. A read:ddos és write:ddos jogosultságot külön kell engedélyezni; a meglévő kulcsok nem kapnak új jogosultságokat.
- A panel és az API közös korlátai, a sorosított módosítások és a POST és DELETE esetén kötelező Idempotency-Key védenek a tömeges szabályküldés és a párhuzamos kérések ellen.
v1.2.2 (2026-10-27)
- POST /v1/orders: ha egy kifizetett szolgáltatás nem építhető ki azonnal, az azonosítója mostantól az awaiting_setup mezőben szerepel (status awaiting_setup), nem pedig a provisioning_failures mezőben, partial status értékkel. A rendszer automatikusan kiépíti, amint ez lehetséges, ezután az állapota active lesz. Ebben az esetben ne adja le újra a rendelést.
v1.2.1 (2026-10-26)
- Dedicated Unlimited Traffic VPN: új, felárral elérhető helyszínek Európában, Észak- és Dél-Amerikában, Ázsiában, a Közel-Keleten, Afrikában és Ausztráliában. A GET /v1/products/{id} megjelenített névvel és felárral listázza őket. Ha egy ilyen helyszín éppen elfogyott, a POST /v1/orders válasza HTTP 409 location_sold_out. Megadás nélkül továbbra is az első felsorolt helyszín (Europe) érvényes.
- A Dedicated Unlimited Traffic VPN és a Dedicated High Speed Unlimited Traffic VPN csomagok konfigurálható opciói (helyszín és operációs rendszer) új azonosítót kaptak, ahogy a választható értékeik (sub_options) is. Az azonosítókat a GET /v1/products/{id} hívásból olvassa ki; egy fixen beállított régi azonosító esetén a válasz HTTP 400 validation_failed. Ha e két csomag egy szolgáltatásának status értéke már e változás előtt cancelled, terminated vagy fraud volt, a GET /v1/services/{id} a location mezőben null értéket ad vissza. A High Speed VPN mostantól csak a következő helyszínopciókkal rendelhető: Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) és Poland (Europe).
- Edge Unlimited Traffic VPS: hat új helyszín (Frankfurt am Main, London, Chester, Párizs, Varsó és Washington DC), összesen legfeljebb 25. Az új helyszínek saját sub_option_id értéket kaptak, a meglévő helyszínek azonosítói nem változtak. Néhány csomagnál az alapár és a helyszíni felárak aránya megváltozott, a meglévő helyszínek teljes ára változatlan. Az azonosítókat és az árakat mindig a GET /v1/products/{id} hívásból olvassa ki.
v1.2.0 (2026-10-24)
- POST /v1/orders helyszínválasztásos termékeknél (Edge Unlimited Traffic VPS): a helyszín opciónak nincs alapértéke, ezért a config_options mezőben meg kell adni, különben HTTP 422 a válasz (reason location_required). Elfogyott helyszín esetén a válasz HTTP 409 location_sold_out. Az új, opcionális storage_gb mező a teljes tárhelyet adja meg 20 és 300 GB között. 20 GB benne van a csomag árában, és a mező elhagyásakor ez érvényes, minden további GB a GET /v1/products/{id} szerinti áron kerül elszámolásra. Más érték esetén HTTP 422 storage_out_of_range a válasz.
- Ezeknél a termékeknél a rendelés eredménye tartalmazza a location és a storage_gb (teljes tárhely GB-ban) mezőt, a GET /v1/products/{id} pedig a storage mezőben írja le a tárhely tartományát és a további GB-onkénti árat. A GET /v1/services és a GET /v1/services/{id} minden szolgáltatásnál visszaadja a location és a storage_gb mezőt (null, ha a terméknél nincs ilyen választás).
- A GET /v1/products/{id} az opciók választható értékeit (sub_options) mostantól csak a megjelenített nevükkel adja vissza (például "Finland (Europe)"), az előttük álló belső érték nélkül. A POST /v1/orders az éppen elfogyott termékeket HTTP 409 out_of_stock válasszal elutasítja.
v1.1.0 (2026-09-23)
- POST /v1/orders: a config_options csak a boltban látható opciókat és értékeket fogadja el, a mennyiségeket pedig csak a határaikon belül. A kihagyott látható opciók az első felsorolt értéket kapják, pontosan úgy, mint a boltban. A GET /v1/products/{id} csak a rendelhető opciókat listázza, és visszaadja a quantity.min és quantity.max értéket.
- Új rendelési állapot: awaiting_setup, az awaiting_setup mezővel azokhoz a termékekhez, amelyeket a KernelHost csapata kézzel állít be. Az automatikusan kiépített szolgáltatások pontosan egyszer kerülnek kiépítésre.
- A kérések body-ja legfeljebb 64 KB lehet (HTTP 413). Fiókonként, az összes kulcsra együtt percenként 120 kérés a korlát, és egy fiókhoz legfeljebb 20 aktív kulcs tartozhat. A sikertelen hitelesítés már nem zárol kulcsot, és az Idempotency-Key a metódushoz és az útvonalhoz kötött.
- A több lekérdezési paramétert tartalmazó kéréseket (például GET /v1/services?limit=10&offset=0) a szerver HTTP 401-gyel elutasította. Az aláírás mostantól pontosan a dokumentáció szerint tartalmazza a query stringet.
v1.0.0 (2026-05-14)
- Első kiadás. Mind a 15 végpont, HMAC hitelesítés, AES-GCM titoktárolás, sebességkorlátok, idempotencia, audit-napló.
- 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.

