Démarrer avec l’API

Créer une clé, faire votre premier appel et comprendre la réponse, en cinq minutes.

L’API CorceLink pilote vos services par programme : lister vos VPS, les redémarrer, lire leurs mesures, gérer leur pare-feu et leur reverse DNS. Tout passe par https://api.corcelink.fr/v1, en HTTPS et en JSON.

1. Créer une clé

Dans l’espace client, ouvrez Mon compte > Accès API. Donnez un nom à la clé (« Supervision », « Script de sauvegarde »), choisissez ses permissions, sa durée de validité et, si vous le souhaitez, les adresses IP autorisées, puis Créer la clé.

Seul le titulaire du compte peut créer ou révoquer des clés. Donnez à chaque clé les seules permissions dont elle a besoin (voir Authentification).

2. Faire un premier appel

Gardez la clé dans une variable d’environnement plutôt que dans votre code :

export CORCELINK_API_KEY="clk_live_…"
curl https://api.corcelink.fr/v1/account -H "Authorization: Bearer $CORCELINK_API_KEY"

La même chose en Python et en JavaScript :

import os, requests

r = requests.get("https://api.corcelink.fr/v1/compute/vps",
                 headers={"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}"}, timeout=30)
r.raise_for_status()
for vps in r.json()["data"]:
    print(vps["id"], vps["status"], vps["region"])

const res = await fetch("https://api.corcelink.fr/v1/compute/vps", {
  headers: { Authorization: `Bearer ${process.env.CORCELINK_API_KEY}` },
});
const { data } = await res.json();
data.forEach((vps) => console.log(vps.id, vps.status, vps.region));

3. Lire la réponse

{
  "data": [
    {
      "id": "vps-7c2e4a91",
      "hostname": "vps-7c2e4a91.vps.corce.link",
      "status": "running",
      "plan": { "id": "vps-start", "name": "VPS Start" },
      "region": "fr-lys-1",
      "billing": { "billing_cycle": "monthly", "price": { "amount": 790, "currency": "EUR" } }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

• Les listes sont dans data, avec has_more et next_cursor pour la suite (voir Pagination).
• Les montants sont en centimes : 790 signifie 7,90 €.
• Chaque réponse porte l’en-tête X-Request-Id : citez-le au support si quelque chose vous surprend.

4. Agir sur un VPS

Une action sur la machine répond tout de suite 202 avec une opération à suivre :

curl -X POST https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/reboot \
  -H "Authorization: Bearer $CORCELINK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

La clé d’idempotence garantit qu’un envoi répété, par exemple après une coupure réseau, ne redémarre pas le serveur une seconde fois. Suivez ensuite l’opération jusqu’à son terme (voir Opérations longues).

Et ensuite