Semantische versionering. Breaking changes (velden hernoemd, endpoints verwijderd, auth-schema gewijzigd) komen uitsluitend in een nieuwe major-versie onder een nieuw URL-prefix /v2/. Binnen /v1/ vinden alleen additieve wijzigingen plaats (nieuwe optionele velden, nieuwe endpoints).

v1.4.0 (2026-11-09)

  • Nieuwe route GET /v1/services/{id}/metrics (scope read:services): servermetingen voor de perioden 1h, 6h, 24h, 7d en 14d. Edge Unlimited Traffic VPS leveren meetwaarden voor CPU, geheugen, netwerk en uitgaand verkeer; reguliere Unlimited Traffic VPS leveren meetwaarden voor netwerk inkomend en uitgaand op de locaties die in de endpoint-referentie staan.
  • Nieuwe routes GET /v1/services/{id}/ddos/attacks en GET /v1/services/{id}/ddos/attacks/{attack_id} (scope read:ddos): aanvalsrapporten voor Remote DDoS Protection tot 90 dagen terug, met verkeersverloop en uitsplitsing naar protocol, poort, bron en pakketgrootte.
  • Profielen en regels (/ddos/profiles, /ddos/rules en de schrijfbewerkingen): een dienst van uw account die geen Advanced DDoS Protection-dienst is, geeft nu HTTP 409 not_supported_for_product in plaats van HTTP 404. Voor onbekende diensten of diensten van een ander account blijft het HTTP 404.

v1.3.1 (2026-11-02)

  • Duitsland en Frankrijk kunt u apart kiezen: bij ‘Duitsland (Europa)’ staat uw server uitsluitend in Duitsland, in Frankfurt, en bij ‘Frankrijk (Europa)’ uitsluitend in Frankrijk.
  • Bij reguliere Unlimited Traffic VPS op de locaties Europa, Duitsland, Frankrijk, Canada Oost, het Verenigd Koninkrijk en Polen kan de oplevering tot 7 dagen duren. In de meeste gevallen is de server binnen 48 uur gereed. De betaalde looptijd begint pas wanneer u de server ontvangt.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: profielen en regels opvragen, regels toevoegen en eigen regels verwijderen via vier nieuwe routes. Schakel read:ddos en write:ddos expliciet in; bestaande sleutels krijgen geen nieuwe rechten.
  • Gedeelde paneel/API-limieten, opeenvolgende wijzigingen en een verplichte Idempotency-Key bij POST en DELETE beschermen tegen regelspam en parallelle verzoeken.

v1.2.2 (2026-10-27)

  • POST /v1/orders: kan een betaalde service niet direct worden ingericht, dan staat de ID van die service nu in het veld awaiting_setup (status awaiting_setup) in plaats van in provisioning_failures met status partial. De service wordt automatisch ingericht zodra dat mogelijk is en gaat daarna over naar active. Plaats in dat geval geen nieuwe bestelling.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: nieuwe locaties met toeslag in Europa, Noord- en Zuid-Amerika, Azië, het Midden-Oosten, Afrika en Australië. GET /v1/products/{id} toont ze met weergavenaam en toeslag. Is zo'n locatie op dat moment uitverkocht, dan geeft POST /v1/orders HTTP 409 location_sold_out. Zonder opgave geldt nog steeds de eerste vermelde locatie (Europe).
  • De configureerbare opties (locatie en besturingssysteem) van de pakketten Dedicated Unlimited Traffic VPN en Dedicated High Speed Unlimited Traffic VPN hebben nieuwe ID's, net als hun subopties. Lees de ID's uit GET /v1/products/{id}; een vast ingestelde oude ID geeft HTTP 400 validation_failed. Voor services van deze pakketten waarvan het veld status vóór deze wijziging al cancelled, terminated of fraud was, geeft GET /v1/services/{id} voortaan null terug voor location. De High Speed VPN is nu alleen nog te bestellen met de locatieopties Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) en Poland (Europe).
  • Edge Unlimited Traffic VPS: zes nieuwe locaties (Frankfurt am Main, Londen, Chester, Parijs, Warschau en Washington DC), in totaal tot 25. De nieuwe locaties hebben eigen sub_option_id-waarden, de ID's van de bestaande locaties blijven gelijk. Bij sommige pakketten zijn basisprijs en locatietoeslagen anders verdeeld, de totaalprijzen van de bestaande locaties blijven gelijk. Lees ID's en prijzen altijd uit GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders voor producten met locatiekeuze (Edge Unlimited Traffic VPS): de locatieoptie heeft geen standaardwaarde en moet in config_options worden meegestuurd, anders HTTP 422 met reason location_required. Een uitverkochte locatie geeft HTTP 409 location_sold_out. Het nieuwe optionele veld storage_gb bepaalt de totale opslag van 20 tot 300 GB. 20 GB zit in de pakketprijs en geldt als u het veld weglaat, elke extra GB wordt berekend tegen de prijs uit GET /v1/products/{id}. Andere waarden geven HTTP 422 storage_out_of_range.
  • Voor deze producten bevat het bestelresultaat location en storage_gb (totale opslag in GB), en GET /v1/products/{id} beschrijft in het veld storage het opslagbereik en de prijs per extra GB. GET /v1/services en GET /v1/services/{id} geven location en storage_gb voor elke service terug (null als het product zo'n keuze niet heeft).
  • GET /v1/products/{id} geeft subopties alleen nog met hun weergavenaam terug (bijvoorbeeld "Finland (Europe)"), zonder de interne waarde ervoor. POST /v1/orders weigert producten die op dat moment uitverkocht zijn met HTTP 409 out_of_stock.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options accepteert alleen opties en waarden die in de shop zichtbaar zijn, en aantallen binnen hun grenzen. Zichtbare opties die u weglaat krijgen de eerste vermelde waarde, precies zoals in de shop. GET /v1/products/{id} toont alleen bestelbare opties en geeft quantity.min en quantity.max terug.
  • Nieuwe bestelstatus awaiting_setup met het veld awaiting_setup voor producten die het KernelHost-team handmatig inricht. Automatisch geleverde services worden precies één keer geprovisioneerd.
  • Request-bodies zijn beperkt tot 64 KB (HTTP 413). Per account geldt over alle sleutels een limiet van 120 verzoeken per minuut, en een account kan maximaal 20 actieve sleutels hebben. Een mislukte authenticatie blokkeert geen sleutel meer en de Idempotency-Key is gekoppeld aan methode en pad.
  • Verzoeken met meer dan één queryparameter (bijvoorbeeld GET /v1/services?limit=10&offset=0) werden met HTTP 401 geweigerd. De handtekening dekt de querystring nu precies zoals gedocumenteerd.

v1.0.0 (2026-05-14)

  • Eerste uitgave. Alle 15 endpoints, HMAC-authenticatie, AES-GCM-opslag van geheime sleutels, snelheidsbeperkingen, idempotentie, auditlogboek.
  • 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.