Versionnement sémantique. Les ruptures (champs renommés, points de terminaison retirés, schéma d'authentification modifié) n'arrivent que dans une nouvelle version majeure sous un nouveau préfixe d'URL /v2/. Dans /v1/, seuls des changements additifs ont lieu (nouveaux champs optionnels, nouveaux points de terminaison).
v1.4.0 (2026-11-09)
- Nouvelle route GET /v1/services/{id}/metrics (permission read:services) : métriques serveur pour les périodes 1h, 6h, 24h, 7d et 14d. Les Edge Unlimited Traffic VPS fournissent les mesures du CPU, de la mémoire, du réseau et du trafic sortant ; les VPS Unlimited Traffic classiques fournissent celles du réseau entrant et sortant aux emplacements indiqués dans la référence des points de terminaison.
- Nouvelles routes GET /v1/services/{id}/ddos/attacks et GET /v1/services/{id}/ddos/attacks/{attack_id} (permission read:ddos) : rapports d'attaques pour Remote DDoS Protection sur 90 jours au maximum, avec courbe de trafic et répartition par protocole, port, source et taille de paquet.
- Profils et règles (/ddos/profiles, /ddos/rules et les opérations d'écriture) : un service de votre compte qui n'est pas un service Advanced DDoS Protection renvoie désormais HTTP 409 not_supported_for_product au lieu de HTTP 404. Les identifiants de service inconnus ou appartenant à autrui renvoient toujours HTTP 404.
v1.3.1 (2026-11-02)
- Vous pouvez choisir l’Allemagne et la France séparément : « Allemagne (Europe) » place votre serveur uniquement en Allemagne, à Francfort, et « France (Europe) » uniquement en France.
- Pour les VPS Unlimited Traffic classiques en Europe, en Allemagne, en France, dans l’est du Canada, au Royaume-Uni et en Pologne, la mise à disposition peut prendre jusqu’à 7 jours. Dans la plupart des cas, le serveur est prêt sous 48 heures. La période facturée commence uniquement à la réception du serveur.
v1.3.0 (2026-11-02)
- Advanced DDoS Protection : consulter les profils et les règles, ajouter des règles et supprimer vos propres règles via quatre nouvelles routes. Activez explicitement read:ddos et write:ddos ; les clés existantes ne reçoivent aucun nouveau droit.
- Des limites communes au panel et à l'API, des modifications sérialisées et Idempotency-Key obligatoire pour POST et DELETE protègent contre l'envoi massif de règles et les requêtes parallèles.
v1.2.2 (2026-10-27)
- POST /v1/orders : si un service payé ne peut pas être provisionné immédiatement, son identifiant figure désormais dans le champ awaiting_setup (status awaiting_setup) et non plus dans provisioning_failures avec status partial. Il est provisionné automatiquement dès que possible, puis son status passe à active. Dans ce cas, ne passez pas de nouvelle commande.
v1.2.1 (2026-10-26)
- Dedicated Unlimited Traffic VPN : nouveaux emplacements avec supplément en Europe, dans les Amériques, en Asie, au Moyen-Orient, en Afrique et en Australie. GET /v1/products/{id} les liste avec leur nom d'affichage et leur supplément. Si l'un de ces emplacements est actuellement épuisé, POST /v1/orders renvoie HTTP 409 location_sold_out. Sans indication, le premier emplacement listé (Europe) s'applique toujours.
- Les options configurables (emplacement et système d'exploitation) des offres Dedicated Unlimited Traffic VPN et Dedicated High Speed Unlimited Traffic VPN ont de nouveaux identifiants, tout comme leurs sous-options. Lisez les identifiants via GET /v1/products/{id} ; un ancien identifiant codé en dur renvoie HTTP 400 validation_failed. Pour les services de ces offres dont le champ status valait déjà cancelled, terminated ou fraud avant ce changement, GET /v1/services/{id} renvoie location à null. Le High Speed VPN ne peut désormais être commandé qu'avec les options d'emplacement Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) et Poland (Europe).
- Edge Unlimited Traffic VPS : six nouveaux emplacements (Frankfurt am Main, Londres, Chester, Paris, Varsovie et Washington DC), jusqu'à 25 au total. Les nouveaux emplacements ont leurs propres valeurs sub_option_id, les identifiants des emplacements existants restent inchangés. Pour certaines offres, le prix de base et les suppléments d'emplacement sont répartis différemment, les prix totaux des emplacements existants restent identiques. Lisez toujours les identifiants et les prix via GET /v1/products/{id}.
v1.2.0 (2026-10-24)
- POST /v1/orders pour les produits avec choix de l'emplacement (Edge Unlimited Traffic VPS) : l'option d'emplacement n'a pas de valeur par défaut et doit être envoyée dans config_options, sinon HTTP 422 avec reason location_required. Un emplacement épuisé renvoie HTTP 409 location_sold_out. Le nouveau champ facultatif storage_gb définit le stockage total de 20 à 300 Go. 20 Go sont inclus dans le prix de l'offre et s'appliquent si le champ est omis, chaque Go supplémentaire est facturé au prix indiqué par GET /v1/products/{id}. Toute autre valeur donne HTTP 422 storage_out_of_range.
- Pour ces produits, le résultat de la commande contient location et storage_gb (stockage total en Go), et GET /v1/products/{id} décrit dans le champ storage la plage de stockage et le prix par Go supplémentaire. GET /v1/services et GET /v1/services/{id} renvoient location et storage_gb pour chaque service (null si le produit n'offre pas ce choix).
- GET /v1/products/{id} renvoie les sous-options uniquement avec leur nom d'affichage (par exemple "Finland (Europe)"), sans la valeur interne qui le précédait. POST /v1/orders refuse les produits actuellement épuisés avec HTTP 409 out_of_stock.
v1.1.0 (2026-09-23)
- POST /v1/orders : config_options n'accepte que les options et valeurs visibles dans la boutique, et les quantités dans leurs limites. Les options visibles que vous omettez reçoivent la première valeur listée, exactement comme dans la boutique. GET /v1/products/{id} ne liste que les options commandables et renvoie quantity.min et quantity.max.
- Nouveau statut de commande awaiting_setup avec le champ awaiting_setup pour les produits que l'équipe KernelHost configure manuellement. Les services provisionnés automatiquement le sont exactement une fois.
- Les corps de requête sont limités à 64 Ko (HTTP 413). Une limite de 120 requêtes par minute s'applique par compte, toutes clés confondues, et un compte peut détenir jusqu'à 20 clés actives. Une authentification échouée ne verrouille plus aucune clé et l'Idempotency-Key est liée à la méthode et au chemin.
- Les requêtes comportant plusieurs paramètres dans la query string (par exemple GET /v1/services?limit=10&offset=0) étaient rejetées avec HTTP 401. La signature couvre désormais la query string exactement comme documenté.
v1.0.0 (2026-05-14)
- Version initiale. Les 15 points de terminaison, authentification HMAC, stockage des secrets en AES-GCM, limites de débit, idempotence, journal d'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.

