Régions et catalogue
Les régions où vos services peuvent être hébergés.
Lister les régions
GET
/v1/catalog/regionsPermission : vps:read
Réponse 200
| Champ | Type | Description |
|---|---|---|
data | liste de objet | |
data[].id | texte | Identifiant de la région (pays, site, numéro). Exemple : "fr-lys-1". |
data[].name | texte | Ville. Exemple : "Lyon". |
data[].country | texte | Pays (ISO 3166-1). Exemple : "FR". |
data[].available | booléen | Des VPS peuvent y être créés. |
Erreurs
- Et les erreurs communes :
missing_api_key,invalid_api_key,missing_scope,ip_not_allowed,rate_limited.
curl "https://api.corcelink.fr/v1/catalog/regions" \
-H "Authorization: Bearer $CORCELINK_API_KEY"import os, uuid, requests
r = requests.get(
"https://api.corcelink.fr/v1/catalog/regions",
headers={"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const res = await fetch("https://api.corcelink.fr/v1/catalog/regions", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.CORCELINK_API_KEY}` },
});
console.log(res.status, await res.json());Réponse 200
{
"data": [
{
"id": "fr-lys-1",
"name": "Lyon",
"country": "FR",
"available": true
}
]
}Essayer avec votre clé
Votre clé reste dans ce navigateur et n’est envoyée qu’à api.corcelink.fr.
Lister les offres
GET
/v1/catalog/productsPermission : vps:read
Offres de chaque famille (VPS de la gamme NOVA, réseaux privés…), avec leurs caractéristiques, leurs prix et leurs régions.
Paramètres de requête
| Champ | Type | Description |
|---|---|---|
family | texte | Valeurs : vps, private_network, dedicated_server, web_hosting, email, domain, other. |
Réponse 200
| Champ | Type | Description |
|---|---|---|
data | liste de objet | |
data[].id | texte | Exemple : "vps-pro". |
data[].family | texte | Famille de produits ; la liste s’enrichira avec les prochaines offres. Valeurs : vps, private_network, dedicated_server, web_hosting, email, domain, other. |
data[].name | texte | Exemple : "VPS Pro". |
data[].description | texte | Exemple : "Pensé pour la production : multi-services, fort trafic". |
data[].specs | objet ou objet | Caractéristiques d’une offre VPS. |
data[].specs.family | texte | |
data[].specs.vcpus | entier | Exemple : 8. |
data[].specs.memory_gb | entier | Exemple : 16. |
data[].specs.disk_gb | entier | Exemple : 200. |
data[].prices | liste de objet | |
data[].prices[].billing_cycle | texte | Valeurs : monthly, annually. |
data[].prices[].price | objet | |
data[].prices[].monthly_equivalent | objet | |
data[].regions | liste de texte |
Erreurs
invalid_parameterParamètre invalide- Et les erreurs communes :
missing_api_key,invalid_api_key,missing_scope,ip_not_allowed,rate_limited.
curl "https://api.corcelink.fr/v1/catalog/products" \
-H "Authorization: Bearer $CORCELINK_API_KEY"import os, uuid, requests
r = requests.get(
"https://api.corcelink.fr/v1/catalog/products",
headers={"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const res = await fetch("https://api.corcelink.fr/v1/catalog/products", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.CORCELINK_API_KEY}` },
});
console.log(res.status, await res.json());Réponse 200
{
"data": []
}Essayer avec votre clé
Votre clé reste dans ce navigateur et n’est envoyée qu’à api.corcelink.fr.
Lister les systèmes et images ISO
GET
/v1/catalog/imagesPermission : vps:read
Paramètres de requête
| Champ | Type | Description |
|---|---|---|
type | texte | Valeurs : template, iso. |
vps_id | texte | Images proposées pour ce VPS |
Réponse 200
| Champ | Type | Description |
|---|---|---|
data | liste de objet | |
data[].id | texte | Exemple : "ubuntu-24.04". |
data[].name | texte | Exemple : "Ubuntu 24.04". |
data[].family | texte | Exemple : "ubuntu". |
data[].version | texte | Exemple : "24.04". |
data[].lts | booléen | |
data[].type | texte | Système à installer, ou image ISO à démarrer. Valeurs : template, iso. |
data[].logo_url | texte ou null | Logo de la famille ; null si aucun. Exemple : "https://cdn.corcelink.fr/assets/img/os/ubuntu.svg". |
Erreurs
invalid_parameterParamètre invalidenot_foundRessource introuvable- Et les erreurs communes :
missing_api_key,invalid_api_key,missing_scope,ip_not_allowed,rate_limited.
curl "https://api.corcelink.fr/v1/catalog/images" \
-H "Authorization: Bearer $CORCELINK_API_KEY"import os, uuid, requests
r = requests.get(
"https://api.corcelink.fr/v1/catalog/images",
headers={"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const res = await fetch("https://api.corcelink.fr/v1/catalog/images", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.CORCELINK_API_KEY}` },
});
console.log(res.status, await res.json());Réponse 200
{
"data": [
{
"id": "debian-13",
"name": "Debian 13",
"family": "debian",
"version": "13",
"lts": false,
"type": "template",
"logo_url": "https://cdn.corcelink.fr/assets/img/os/debian.svg"
},
{
"id": "systemrescue-11",
"name": "SystemRescue 11",
"family": "systemrescue",
"version": "11",
"lts": false,
"type": "iso",
"logo_url": null
},
{
"id": "ubuntu-24.04",
"name": "Ubuntu 24.04",
"family": "ubuntu",
"version": "24.04",
"lts": true,
"type": "template",
"logo_url": "https://cdn.corcelink.fr/assets/img/os/ubuntu.svg"
}
]
}Essayer avec votre clé
Votre clé reste dans ce navigateur et n’est envoyée qu’à api.corcelink.fr.