Semantische Versionierung. Breaking Changes (Felder umbenannt, Endpoints entfernt, Auth-Schema geändert) erfolgen nur in einer neuen Major-Version unter neuem URL-Prefix /v2/. Innerhalb /v1/ kommen nur additive Änderungen (neue optionale Felder, neue Endpoints).

v1.4.0 (2026-11-09)

  • Neue Route GET /v1/services/{id}/metrics (Scope read:services): Servermesswerte für die Zeiträume 1h, 6h, 24h, 7d und 14d. Edge Unlimited Traffic VPS liefern Werte für CPU, Arbeitsspeicher, Netzwerk und ausgehenden Traffic, reguläre Unlimited Traffic VPS an den in der Endpoint-Referenz genannten Standorten Netzwerkwerte ein- und ausgehend.
  • Neue Routen GET /v1/services/{id}/ddos/attacks und GET /v1/services/{id}/ddos/attacks/{attack_id} (Scope read:ddos): Angriffsberichte für Remote DDoS Protection über bis zu 90 Tage, mit Verkehrsverlauf und Aufschlüsselung nach Protokoll, Port, Quelle und Paketgröße.
  • Profile und Regeln (/ddos/profiles, /ddos/rules und die schreibenden Aufrufe): Ein Dienst des eigenen Kontos, der kein Advanced-DDoS-Protection-Dienst ist, ergibt jetzt HTTP 409 not_supported_for_product statt HTTP 404. Unbekannte oder fremde Service-IDs ergeben weiterhin HTTP 404.

v1.3.1 (2026-11-02)

  • Deutschland und Frankreich können Sie getrennt wählen: Mit „Deutschland (Europa)“ steht Ihr Server nur in Deutschland (Frankfurt), mit „Frankreich (Europa)“ nur in Frankreich.
  • Bei regulären Unlimited Traffic VPS kann die Bereitstellung an den Standorten Europa, Deutschland, Frankreich, Kanada Ost, Vereinigtes Königreich und Polen bis zu 7 Tage dauern. In den meisten Fällen steht der Server innerhalb von 48 Stunden bereit. Die Laufzeit beginnt erst mit Erhalt des Servers.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: Profile und Regeln abrufen, Regeln hinzufügen und eigene Regeln löschen über vier neue Routen. Die neuen Scopes read:ddos und write:ddos ausdrücklich aktivieren; bestehende Schlüssel erhalten keine neuen Rechte.
  • Gemeinsame Grenzen für Panel und API, nacheinander ausgeführte Änderungen und verpflichtender Idempotency-Key bei POST und DELETE schützen gegen Regel-Spam und parallele Anfragen.

v1.2.2 (2026-10-27)

  • POST /v1/orders: Kann ein bezahlter Service nicht sofort eingerichtet werden, steht seine ID jetzt im Feld awaiting_setup (status awaiting_setup) statt in provisioning_failures mit status partial. Er wird automatisch eingerichtet, sobald es möglich ist, und wechselt danach auf active. Bestellen Sie in diesem Fall nicht erneut.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: neue Standorte mit Aufpreis in Europa, Nord- und Südamerika, Asien, im Nahen Osten, in Afrika und Australien. GET /v1/products/{id} listet sie mit Anzeigenamen und Aufpreis. Ist ein solcher Standort gerade ausverkauft, antwortet POST /v1/orders mit HTTP 409 location_sold_out. Ohne Angabe gilt weiter der erste gelistete Standort (Europe).
  • Die Konfigurationsoptionen (Standort und Betriebssystem) der Tarife Dedicated Unlimited Traffic VPN und Dedicated High Speed Unlimited Traffic VPN haben neue IDs, ebenso ihre Unteroptionen. Lesen Sie die IDs aus GET /v1/products/{id}, eine fest hinterlegte alte ID ergibt HTTP 400 validation_failed. Bei Services dieser Tarife, deren status schon vor dieser Änderung cancelled, terminated oder fraud war, ist location in GET /v1/services/{id} künftig null. Den High Speed VPN gibt es nur noch mit den Standortoptionen Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) und Poland (Europe).
  • Edge Unlimited Traffic VPS: sechs neue Standorte (Frankfurt am Main, London, Chester, Paris, Warschau und Washington DC), insgesamt bis zu 25. Die neuen Standorte haben eigene sub_option_id-Werte, die IDs der bisherigen Standorte bleiben gleich. Bei einigen Tarifen sind Grundpreis und Standortaufpreise neu aufgeteilt, die Gesamtpreise der bisherigen Standorte bleiben gleich. Lesen Sie IDs und Preise immer aus GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders bei Produkten mit Standortwahl (Edge Unlimited Traffic VPS): Die Standortoption hat keinen Standardwert und muss in config_options mitgeschickt werden, sonst HTTP 422 mit reason location_required. Ein ausverkaufter Standort ergibt HTTP 409 location_sold_out. Das neue optionale Feld storage_gb legt den gesamten Speicher von 20 bis 300 GB fest. 20 GB sind im Tarifpreis enthalten und gelten ohne Angabe, jedes weitere GB wird zum Preis aus GET /v1/products/{id} berechnet. Andere Werte ergeben HTTP 422 storage_out_of_range.
  • Bei diesen Produkten enthält das Bestellergebnis location und storage_gb (Gesamtspeicher in GB), und GET /v1/products/{id} beschreibt im Feld storage den Speicherbereich und den Preis je zusätzlichem GB. GET /v1/services und GET /v1/services/{id} liefern location und storage_gb für jeden Service (null, wenn das Produkt keine solche Wahl hat).
  • GET /v1/products/{id} liefert Unteroptionen nur noch mit ihrem Anzeigenamen (etwa "Finland (Europe)"), ohne den internen Wert davor. POST /v1/orders lehnt Produkte, die gerade ausverkauft sind, mit HTTP 409 out_of_stock ab.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options akzeptiert nur Optionen und Werte, die im Shop sichtbar sind, und Mengen nur innerhalb ihrer Grenzen. Nicht angegebene sichtbare Optionen erhalten den ersten gelisteten Wert, genau wie im Shop. GET /v1/products/{id} listet nur bestellbare Optionen und liefert quantity.min und quantity.max.
  • Neuer Bestellstatus awaiting_setup mit dem Feld awaiting_setup für Produkte, die das KernelHost-Team manuell einrichtet. Automatisch bereitgestellte Services werden genau einmal provisioniert.
  • Request-Bodies sind auf 64 KB begrenzt (HTTP 413). Pro Konto gilt über alle Keys ein Limit von 120 Anfragen pro Minute, ein Konto kann bis zu 20 aktive Keys halten. Fehlgeschlagene Anmeldungen sperren keinen Key mehr, und der Idempotency-Key ist an Methode und Pfad gebunden.
  • Anfragen mit mehr als einem Query-Parameter (etwa GET /v1/services?limit=10&offset=0) wurden mit HTTP 401 abgelehnt. Die Signatur deckt den Query-String jetzt genau so ab, wie es dokumentiert ist.

v1.0.0 (2026-05-14)

  • Erste Veröffentlichung. Alle 15 Endpoints, HMAC-Auth, AES-GCM Secret-Storage, Rate-Limits, Idempotenz, Audit-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.