Változásnapló

KernelHost API

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.