Istoric versiuni

KernelHost API

Versionare semantică. Schimbările cu impact (câmpuri redenumite, endpointuri eliminate, schemă de autentificare modificată) apar doar într-o nouă versiune majoră, sub un nou prefix URL /v2/. În /v1/ apar exclusiv modificări aditive (câmpuri opționale noi, endpointuri noi).

v1.4.0 (2026-11-09)

  • Rută nouă GET /v1/services/{id}/metrics (permisiunea read:services): metrici de server pentru intervalele 1h, 6h, 24h, 7d și 14d. Edge Unlimited Traffic VPS furnizează date despre CPU, memorie, rețea și traficul de ieșire, iar VPS-urile Unlimited Traffic din gama obișnuită furnizează date despre rețea la intrare și la ieșire în locațiile indicate în referința endpointurilor.
  • Rute noi GET /v1/services/{id}/ddos/attacks și GET /v1/services/{id}/ddos/attacks/{attack_id} (permisiunea read:ddos): rapoarte privind atacurile pentru Remote DDoS Protection pe cel mult 90 de zile, cu evoluția traficului și defalcare pe protocol, port, sursă și dimensiunea pachetelor.
  • Profiluri și reguli (/ddos/profiles, /ddos/rules și operațiile de scriere): un serviciu al contului dumneavoastră care nu este un serviciu Advanced DDoS Protection returnează acum HTTP 409 not_supported_for_product în loc de HTTP 404. ID-urile de serviciu necunoscute sau străine returnează în continuare HTTP 404.

v1.3.1 (2026-11-02)

  • Germania și Franța pot fi alese separat: „Germania (Europa)” plasează serverul numai în Germania, la Frankfurt, iar „Franța (Europa)” numai în Franța.
  • Pentru VPS-urile Unlimited Traffic din gama obișnuită, în locațiile Europa, Germania, Franța, Canada de Est, Regatul Unit și Polonia, pregătirea poate dura până la 7 zile. În majoritatea cazurilor, serverul este gata în 48 de ore. Perioada plătită începe numai când primiți serverul.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: consultați profiluri și reguli, adăugați reguli și ștergeți reguli proprii prin patru rute noi. Activați explicit read:ddos și write:ddos; cheile existente nu primesc permisiuni noi.
  • Limitele comune panoului și API-ului, modificările executate pe rând și Idempotency-Key obligatoriu pentru POST și DELETE protejează împotriva trimiterii masive de reguli și a cererilor paralele.

v1.2.2 (2026-10-27)

  • POST /v1/orders: dacă un serviciu plătit nu poate fi provizionat imediat, ID-ul său apare acum în câmpul awaiting_setup (status awaiting_setup), și nu în provisioning_failures cu status partial. Serviciul va fi provizionat automat de îndată ce este posibil, apoi va trece la active. În acest caz, nu plasați din nou comanda.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: locații noi cu cost suplimentar în Europa, America de Nord și de Sud, Asia, Orientul Mijlociu, Africa și Australia. GET /v1/products/{id} le listează cu numele afișat și costul suplimentar. Dacă o astfel de locație este epuizată în acel moment, POST /v1/orders returnează HTTP 409 location_sold_out. Fără nicio indicație se aplică în continuare prima locație listată (Europe).
  • Opțiunile configurabile (locație și sistem de operare) ale planurilor Dedicated Unlimited Traffic VPN și Dedicated High Speed Unlimited Traffic VPN au ID-uri noi, la fel ca subopțiunile lor. Citiți ID-urile din GET /v1/products/{id}; un ID vechi fixat în cod returnează HTTP 400 validation_failed. Pentru serviciile acestor planuri la care status avea deja valoarea cancelled, terminated sau fraud înainte de această modificare, GET /v1/services/{id} returnează pentru location valoarea null. High Speed VPN poate fi comandat acum doar cu opțiunile de locație Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) și Poland (Europe).
  • Edge Unlimited Traffic VPS: șase locații noi (Frankfurt am Main, Londra, Chester, Paris, Varșovia și Washington DC), în total până la 25 de locații. Locațiile noi au propriile valori sub_option_id, ID-urile locațiilor existente rămân aceleași. La unele planuri, prețul de bază și costurile suplimentare pe locație sunt împărțite altfel, prețurile totale ale locațiilor existente rămân aceleași. Citiți întotdeauna ID-urile și prețurile din GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders pentru produsele cu alegerea locației (Edge Unlimited Traffic VPS): opțiunea de locație nu are o valoare implicită și trebuie trimisă în config_options, altfel HTTP 422 cu reason location_required. O locație epuizată returnează HTTP 409 location_sold_out. Noul câmp opțional storage_gb stabilește spațiul de stocare total între 20 și 300 GB. 20 GB sunt incluși în prețul planului și se aplică dacă omiteți câmpul, fiecare GB suplimentar se facturează la prețul indicat de GET /v1/products/{id}. Alte valori dau HTTP 422 storage_out_of_range.
  • Pentru aceste produse, rezultatul comenzii conține location și storage_gb (spațiul de stocare total în GB), iar GET /v1/products/{id} descrie în câmpul storage intervalul de stocare și prețul pentru fiecare GB suplimentar. GET /v1/services și GET /v1/services/{id} returnează location și storage_gb pentru fiecare serviciu (null dacă produsul nu are o astfel de opțiune).
  • GET /v1/products/{id} returnează subopțiunile doar cu numele afișat (de exemplu "Finland (Europe)"), fără valoarea internă din fața lui. POST /v1/orders respinge cu HTTP 409 out_of_stock produsele care sunt epuizate în acel moment.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options acceptă doar opțiunile și valorile vizibile în magazin, iar cantitățile doar în limitele lor. Opțiunile vizibile pe care le omiteți primesc prima valoare listată, exact ca în magazin. GET /v1/products/{id} listează doar opțiunile ce pot fi comandate și returnează quantity.min și quantity.max.
  • Stare nouă a comenzii awaiting_setup, cu câmpul awaiting_setup, pentru produsele pe care echipa KernelHost le configurează manual. Serviciile furnizate automat sunt provizionate exact o singură dată.
  • Body-ul cererilor este limitat la 64 KB (HTTP 413). Pe cont se aplică o limită de 120 de cereri pe minut pentru toate cheile împreună, iar un cont poate avea până la 20 de chei active. Autentificarea eșuată nu mai blochează nicio cheie, iar Idempotency-Key este legat de metodă și cale.
  • Cererile cu mai mulți parametri în query string (de exemplu GET /v1/services?limit=10&offset=0) erau respinse cu HTTP 401. Semnătura acoperă acum query string-ul exact așa cum este documentat.

v1.0.0 (2026-05-14)

  • Lansare inițială. Toate cele 15 endpointuri, autentificare HMAC, stocare AES-GCM a codurilor secrete, limite de rată, idempotență, jurnal de audit.
  • 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.