Sémantické verzování. Breaking changes (přejmenovaná pole, odstraněné koncové body, změna autentizačního schématu) probíhají pouze v nové hlavní verzi pod novým URL prefixem /v2/. V rámci /v1/ probíhají pouze aditivní změny (nová volitelná pole, nové koncové body).

v1.4.0 (2026-11-09)

  • Nová cesta GET /v1/services/{id}/metrics (oprávnění read:services): metriky serveru pro období 1h, 6h, 24h, 7d a 14d. Edge Unlimited Traffic VPS poskytují údaje o CPU, paměti, síti a odchozím přenosu, běžné Unlimited Traffic VPS údaje o příchozím a odchozím síťovém provozu v lokalitách uvedených v referenci endpointů.
  • Nové cesty GET /v1/services/{id}/ddos/attacks a GET /v1/services/{id}/ddos/attacks/{attack_id} (oprávnění read:ddos): přehledy útoků pro Remote DDoS Protection až 90 dní zpět, s průběhem provozu a členěním podle protokolu, portu, zdroje a velikosti paketů.
  • Profily a pravidla (/ddos/profiles, /ddos/rules a zapisovací operace): služba vašeho účtu, která není službou Advanced DDoS Protection, nyní vrací HTTP 409 not_supported_for_product místo HTTP 404. Neznámá nebo cizí ID služeb nadále vracejí HTTP 404.

v1.3.1 (2026-11-02)

  • Německo a Francii lze vybrat samostatně: „Německo (Evropa)“ znamená umístění pouze v Německu ve Frankfurtu a „Francie (Evropa)“ pouze ve Francii.
  • U běžných Unlimited Traffic VPS v lokalitách Evropa, Německo, Francie, východní Kanada, Spojené království a Polsko může zřízení trvat až 7 dní. Ve většině případů je server připraven do 48 hodin. Zaplacené období začíná až předáním serveru.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: načítání profilů a pravidel, přidávání pravidel a mazání vlastních pravidel prostřednictvím čtyř nových cest. Výslovně povolte read:ddos a write:ddos; stávající klíče nezískávají nová oprávnění.
  • Společné limity panelu a API, postupné provádění změn a povinný Idempotency-Key u POST a DELETE chrání před hromadným vytvářením pravidel a souběžnými požadavky.

v1.2.2 (2026-10-27)

  • POST /v1/orders: pokud zaplacenou službu nelze zřídit hned, je její ID nyní uvedeno v poli awaiting_setup (status awaiting_setup), a ne v provisioning_failures se statusem partial. Služba se zřídí automaticky, jakmile to bude možné, a poté přejde do stavu active. V takovém případě objednávku neopakujte.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: nové lokality s příplatkem v Evropě, Severní a Jižní Americe, Asii, na Blízkém východě, v Africe a Austrálii. GET /v1/products/{id} je uvádí se zobrazovaným názvem a příplatkem. Pokud je taková lokalita právě vyprodaná, vrací POST /v1/orders HTTP 409 location_sold_out. Bez zadání nadále platí první uvedená lokalita (Europe).
  • Konfigurovatelné volby (lokalita a operační systém) tarifů Dedicated Unlimited Traffic VPN a Dedicated High Speed Unlimited Traffic VPN mají nová ID, stejně jako jejich podvolby. ID načítejte z GET /v1/products/{id}; napevno uložené staré ID vede k HTTP 400 validation_failed. U služeb těchto tarifů, jejichž status byl již před touto změnou cancelled, terminated nebo fraud, vrací GET /v1/services/{id} location s hodnotou null. High Speed VPN lze nyní objednat už jen s volbami lokality Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) a Poland (Europe).
  • Edge Unlimited Traffic VPS: šest nových lokalit (Frankfurt am Main, Londýn, Chester, Paříž, Varšava a Washington DC), celkem až 25. Nové lokality mají vlastní hodnoty sub_option_id, ID dosavadních lokalit zůstávají stejná. U některých tarifů jsou základní cena a příplatky za lokalitu rozděleny nově, celkové ceny dosavadních lokalit zůstávají stejné. ID a ceny vždy načítejte z GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders u produktů s volbou lokality (Edge Unlimited Traffic VPS): volba lokality nemá výchozí hodnotu a musí být odeslána v config_options, jinak HTTP 422 s reason location_required. Vyprodaná lokalita vrací HTTP 409 location_sold_out. Nové volitelné pole storage_gb určuje celkové úložiště od 20 do 300 GB. 20 GB je zahrnuto v ceně tarifu a platí, pokud pole vynecháte, každý další GB se účtuje za cenu uvedenou v GET /v1/products/{id}. Jiné hodnoty vedou k HTTP 422 storage_out_of_range.
  • U těchto produktů obsahuje výsledek objednávky location a storage_gb (celkové úložiště v GB) a GET /v1/products/{id} popisuje v poli storage rozsah úložiště a cenu za každý další GB. GET /v1/services a GET /v1/services/{id} vracejí location a storage_gb u každé služby (null, pokud produkt takovou volbu nemá).
  • GET /v1/products/{id} vrací podvolby už jen s jejich zobrazovaným názvem (například "Finland (Europe)"), bez interní hodnoty před ním. POST /v1/orders odmítá produkty, které jsou právě vyprodané, s HTTP 409 out_of_stock.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options přijímá pouze volby a hodnoty viditelné v obchodě a množství v rámci jejich limitů. Viditelné volby, které vynecháte, dostanou první uvedenou hodnotu, přesně jako v obchodě. GET /v1/products/{id} uvádí pouze objednatelné volby a vrací quantity.min a quantity.max.
  • Nový stav objednávky awaiting_setup s polem awaiting_setup pro produkty, které tým KernelHost nastavuje ručně. Automaticky zřizované služby se zřizují právě jednou.
  • Těla požadavků jsou omezena na 64 KB (HTTP 413). Pro každý účet platí napříč všemi klíči limit 120 požadavků za minutu a účet může mít až 20 aktivních klíčů. Neúspěšné ověření už žádný klíč nezablokuje a Idempotency-Key je vázán na metodu a cestu.
  • Požadavky s více než jedním parametrem v query stringu (například GET /v1/services?limit=10&offset=0) byly odmítány s HTTP 401. Podpis nyní zahrnuje query string přesně podle dokumentace.

v1.0.0 (2026-05-14)

  • První vydání. Všech 15 koncových bodů, HMAC autentizace, ukládání tajných klíčů AES-GCM, omezení rychlosti, idempotence, auditní log.
  • 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.