API cloud française

Non : l’API est incluse avec chaque compte client, sans supplément. Vous ne payez que vos services, par exemple un VPS Nova dès 7,90 € par mois. Chaque compte peut avoir jusqu’à 20 clés actives, et chaque clé dispose de 600 requêtes par minute, dont 120 écritures.

Le compte et l’inventaire de vos services, les régions et le catalogue, les VPS (alimentation, mesures, journal, réinstallation, clés SSH, console, images ISO), leurs adresses IP et leur reverse DNS, leur pare-feu, les réseaux privés, les sauvegardes des VPS, les factures et devis, les demandes d’assistance et le suivi des opérations. Toutes les routes de la version 1 sont en service.

Non, pas aujourd’hui : la version 1 de l’API ne comporte pas de route de commande. Un VPS Nova se commande dans l’espace client, où il est livré en moins de 2 minutes ; l’API prend ensuite le relais pour le piloter : démarrage, réinstallation, pare-feu, reverse DNS, sauvegardes, réseaux privés. L’inventaire /v1/services liste déjà tous vos services, quelle que soit leur famille.

Donnez à chaque usage sa propre clé, avec le minimum de permissions, une date d’expiration et, dès que possible, une liste d’adresses IP autorisées. Gardez-la dans une variable d’environnement ou un coffre de secrets, jamais dans un dépôt Git : elle ne s’affiche qu’une fois, à sa création. Au moindre doute, révoquez-la dans Mon compte > Accès API : c’est immédiat.

Rien de fâcheux si vous utilisez l’idempotence : envoyez chaque écriture avec un en-tête Idempotency-Key unique, par exemple un UUID, et réutilisez-le pour réessayer. Pendant 24 heures, l’API renvoie la réponse d’origine sans refaire l’action. Un redémarrage envoyé deux fois ne redémarre donc pas le serveur deux fois.

La version majeure figure dans l’adresse (/v1) et, dans une version, les changements sont seulement additifs : nouvelles routes, nouveaux champs, nouvelles valeurs. Un changement incompatible ouvrirait une nouvelle version, et l’ancienne resterait servie au moins 12 mois, avec les en-têtes Deprecation et Sunset. Il suffit que vos programmes tolèrent les champs inconnus.

Oui : dans la référence de docs.corcelink.fr, les routes de lecture ont un bouton « Essayer » qui envoie la requête avec votre clé, laquelle reste dans votre navigateur et n’est envoyée qu’à api.corcelink.fr. Chaque route a aussi des exemples prêts à copier en cURL, Python et JavaScript.

En français par défaut, en anglais avec l’en-tête Accept-Language: en. Les erreurs suivent le format RFC 9457, avec un code stable (missing_scope, rate_limited…) que vos programmes doivent tester plutôt que le texte, et un request_id à citer au support. Les codes et les valeurs ne changent jamais avec la langue.