Versionamento semantico. Le modifiche incompatibili (campi rinominati, endpoint rimossi, schema di autenticazione modificato) arrivano solo in una nuova major version sotto un nuovo prefisso URL /v2/. All'interno di /v1/ avvengono solo modifiche additive (nuovi campi opzionali, nuovi endpoint).

v1.4.0 (2026-11-09)

  • Nuovo percorso GET /v1/services/{id}/metrics (permesso read:services): metriche del server per i periodi 1h, 6h, 24h, 7d e 14d. Gli Edge Unlimited Traffic VPS forniscono i dati di CPU, memoria, rete e traffico in uscita; i VPS Unlimited Traffic tradizionali forniscono i dati della rete in ingresso e in uscita nelle sedi indicate nel riferimento degli endpoint.
  • Nuovi percorsi GET /v1/services/{id}/ddos/attacks e GET /v1/services/{id}/ddos/attacks/{attack_id} (permesso read:ddos): report degli attacchi per Remote DDoS Protection fino a 90 giorni, con andamento del traffico e ripartizione per protocollo, porta, origine e dimensione dei pacchetti.
  • Profili e regole (/ddos/profiles, /ddos/rules e le operazioni di scrittura): un servizio del proprio account che non è un servizio Advanced DDoS Protection restituisce ora HTTP 409 not_supported_for_product invece di HTTP 404. Gli ID di servizio sconosciuti o altrui restituiscono ancora HTTP 404.

v1.3.1 (2026-11-02)

  • Germania e Francia si possono scegliere separatamente: «Germania (Europa)» colloca il server solo in Germania, a Francoforte, e «Francia (Europa)» solo in Francia.
  • Per i VPS Unlimited Traffic tradizionali in Europa, Germania, Francia, Canada orientale, Regno Unito e Polonia, l’attivazione può richiedere fino a 7 giorni. Nella maggior parte dei casi il server è pronto entro 48 ore. Il periodo fatturato inizia solo quando ricevi il server.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: consultare profili e regole, aggiungere regole ed eliminare le proprie regole tramite quattro nuovi percorsi. Attivare esplicitamente read:ddos e write:ddos; le chiavi esistenti non ricevono nuovi permessi.
  • Limiti condivisi tra pannello e API, modifiche serializzate e Idempotency-Key obbligatorio per POST e DELETE proteggono dall'invio massivo di regole e dalle richieste parallele.

v1.2.2 (2026-10-27)

  • POST /v1/orders: se un servizio pagato non può essere attivato subito, il suo ID compare ora nel campo awaiting_setup (status awaiting_setup) invece che in provisioning_failures con status partial. Verrà attivato automaticamente non appena possibile e passerà poi ad active. In questo caso l'ordine non va ripetuto.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: nuove sedi con sovrapprezzo in Europa, nelle Americhe, in Asia, in Medio Oriente, in Africa e in Australia. GET /v1/products/{id} le elenca con nome visualizzato e sovrapprezzo. Se una di queste sedi è attualmente esaurita, POST /v1/orders restituisce HTTP 409 location_sold_out. Se non viene indicata alcuna sede, vale ancora la prima elencata (Europe).
  • Le opzioni configurabili (sede e sistema operativo) dei piani Dedicated Unlimited Traffic VPN e Dedicated High Speed Unlimited Traffic VPN hanno nuovi ID, così come le relative sotto-opzioni. Gli ID vanno letti da GET /v1/products/{id}; un vecchio ID inserito in modo fisso nel codice restituisce HTTP 400 validation_failed. Per i servizi di questi piani il cui status era già cancelled, terminated o fraud prima di questa modifica, GET /v1/services/{id} restituisce location con valore null. L'High Speed VPN è ora ordinabile solo con le opzioni di sede Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) e Poland (Europe).
  • Edge Unlimited Traffic VPS: sei nuove sedi (Francoforte sul Meno, Londra, Chester, Parigi, Varsavia e Washington DC), fino a 25 in totale. Le nuove sedi hanno propri valori sub_option_id, gli ID delle sedi esistenti restano invariati. Per alcuni piani il prezzo base e i sovrapprezzi per sede sono ripartiti diversamente, i prezzi totali delle sedi esistenti restano invariati. ID e prezzi vanno sempre letti da GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders per i prodotti con scelta della sede (Edge Unlimited Traffic VPS): l'opzione della sede non ha un valore predefinito e va inviata in config_options, altrimenti HTTP 422 con reason location_required. Una sede esaurita restituisce HTTP 409 location_sold_out. Il nuovo campo facoltativo storage_gb imposta lo spazio di archiviazione totale da 20 a 300 GB. 20 GB sono inclusi nel prezzo del piano e valgono se il campo è omesso; ogni GB aggiuntivo è addebitato al prezzo indicato da GET /v1/products/{id}. Altri valori danno HTTP 422 storage_out_of_range.
  • Per questi prodotti il risultato dell'ordine contiene location e storage_gb (spazio di archiviazione totale in GB), e GET /v1/products/{id} descrive nel campo storage l'intervallo disponibile e il prezzo per ogni GB aggiuntivo. GET /v1/services e GET /v1/services/{id} restituiscono location e storage_gb per ogni servizio (null se il prodotto non prevede questa scelta).
  • GET /v1/products/{id} restituisce le sotto-opzioni solo con il nome visualizzato (ad esempio "Finland (Europe)"), senza il valore interno che lo precedeva. POST /v1/orders rifiuta con HTTP 409 out_of_stock i prodotti attualmente esauriti.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options accetta solo opzioni e valori visibili nello shop e quantità entro i relativi limiti. Le opzioni visibili non indicate ricevono il primo valore elencato, esattamente come nello shop. GET /v1/products/{id} elenca solo le opzioni ordinabili e restituisce quantity.min e quantity.max.
  • Nuovo stato d'ordine awaiting_setup con il campo awaiting_setup per i prodotti che il team KernelHost configura manualmente. I servizi forniti automaticamente vengono attivati esattamente una volta.
  • Il body delle richieste è limitato a 64 KB (HTTP 413). Per ogni account vale un limite di 120 richieste al minuto su tutte le chiavi, e un account può avere fino a 20 chiavi attive. Un'autenticazione non riuscita non blocca più alcuna chiave e l'Idempotency-Key è legata a metodo e percorso.
  • Le richieste con più di un parametro nella query string (ad esempio GET /v1/services?limit=10&offset=0) venivano rifiutate con HTTP 401. Ora la firma copre la query string esattamente come documentato.

v1.0.0 (2026-05-14)

  • Rilascio iniziale. Tutti i 15 endpoint, autenticazione HMAC, storage segreti AES-GCM, limiti di velocità, idempotenza, 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.