Versions et modifications

Comment l’API évolue sans casser vos intégrations, et le journal des modifications.

Notre engagement

La version majeure figure dans l’adresse : /v1.
Dans une version, les changements sont seulement additifs : nouvelles routes, nouveaux champs, nouvelles valeurs. Vos intégrations continuent de fonctionner, à condition de tolérer les champs et valeurs inconnus.
Un changement incompatible ouvre une nouvelle version (/v2). L’ancienne reste servie au moins 12 mois, et ses réponses portent les en-têtes Deprecation et Sunset avec la date d’arrêt.
La version qui a répondu figure dans l’en-tête CorceLink-Api-Version.

Inventaire : tous vos services et noms de domaine, quelle que soit leur famille, filtrables par famille et par état, avec le lien vers leur ressource détaillée.
Support : les départements gardent leur identifiant même s’ils sont renommés.
Toutes les routes de la version 1 sont en service.

Support : départements, liste des demandes filtrable par état, fil des échanges, ouverture (avec le service concerné), réponse et clôture.
Les demandes passent par le même circuit que l’espace client : mêmes départements, mêmes notifications. Lire une demande par l’API ne la marque pas comme lue.

Factures : liste filtrable par état et par année, détail ligne par ligne (période de facturation en dates), reste à régler et document PDF.
Devis : liste, détail avec remises et document PDF.
Les documents sont ceux de l’espace client et des e-mails ; les brouillons n’apparaissent jamais.

Réseaux privés : liste et détail, renommage et mode de configuration par défaut (avec ETag et If-Match).
VPS reliés : ajout, adresses secondaires, contrôle source/destination, mode de configuration, retrait, en opérations suivies.
Routes statiques : liste, ajout et suppression.
Les contrôles sont ceux de l’espace client : mêmes règles (région, plage d’adresses, limites) et mêmes messages.

Console : POST /v1/compute/vps/{vps_id}/console crée un lien https://kvm.corcelink.fr/s/… à ouvrir dans un navigateur. Il vaut une minute et ne sert qu’une fois ; la session de console s’ouvre à ce moment-là.
Opérations : une tâche de l’hyperviseur relancée après une tentative manquée reste running ; failed signale un échec définitif, avec sa cause quand elle est connue.
Erreurs : task_failed et task_lost (statut 502) rejoignent le catalogue.

Sauvegardes : liste avec quota, création, protection, suppression, restauration (opérations suivies) et planification.
Clés SSH : lecture et remplacement, avec ETag et If-Match.
Réinstallation : opération suivie, nouveau mot de passe root remis par un lien à usage unique dans result.
Nouveau mot de passe root, par un lien à usage unique.
ISO : démarrage sur une image et éjection.
Catalogue : systèmes et images ISO, offres VPS de la gamme NOVA avec leurs prix et leurs régions.
Opérations : suivi des tâches de l’hyperviseur pour les sauvegardes, restaurations et réinstallations ; champ result.

Première version publique.

Clés API à permissions, avec adresses autorisées et expiration, gérées dans Mon compte.
Compte : lecture du compte et de la clé utilisée.
Catalogue : régions.
VPS : liste et détail, démarrage, redémarrage, arrêt et arrêt forcé en opérations suivies, mesures, journal.
Adresses IP et reverse DNS.
Pare-feu : état, politiques par défaut, règles à identifiants stables.
Opérations : suivi des opérations longues.
Erreurs RFC 9457 en français et en anglais, idempotence, ETag, quotas, Server-Timing.