API Corenix

Pilotez vos services depuis vos scripts : consulter vos serveurs et factures, mesurer la disponibilité, redémarrer une machine, modifier un reverse DNS ou ouvrir un ticket.

URL de base : https://api.corenix.fr/v1 · Format : JSON (UTF-8) · Protocole : HTTPS uniquement.

Démarrage

1. Connectez-vous à votre espace client, rubrique Jetons API.
2. Créez un jeton en lecture seule ou en lecture et écriture. Copiez-le : il n’est affiché qu’une fois.
3. Envoyez-le à chaque requête.

curl -H "Authorization: Bearer cxk_…" https://api.corenix.fr/v1/services

Authentification

Transmettez le jeton dans l’en-tête Authorization: Bearer cxk_… ou X-Api-Key: cxk_…. Ne l’intégrez jamais à du code public ou à une application distribuée : il donne accès à votre compte dans la limite de ses droits.

Un jeton peut être restreint à des adresses IP (ou réseaux CIDR), limité dans le temps et révoqué à tout moment. Les actions réalisées par l’API apparaissent dans le journal d’activité du compte.

Droits d’un jeton

À la création, vous choisissez le niveau de droits :

Un appel qui dépasse les droits du jeton renvoie 403. Aucun jeton ne permet de payer, de résilier ou de modifier le compte.

Réponses et erreurs

{ "success": true, "data": { … }, "meta": { "page": 1, "limit": 50 } }

{ "success": false, "error": { "message": "Service introuvable.", "code": "not_found" } }

Limites

• 60 requêtes par minute et par jeton. L’en-tête X-RateLimit-Remaining indique ce qu’il reste ; en cas de dépassement, Retry-After donne le délai.
• Une commande d’alimentation toutes les 8 secondes par compte.
• 10 jetons actifs au maximum par compte.

Identifiants de service. Un service se désigne par son identifiant public de 8 caractères (ex. XQW2MJG8), visible dans l’espace client. L’ancien numéro reste accepté.

Compte

Services

Factures

Tickets

Exemples

Lister les services

curl -H "Authorization: Bearer cxk_…" https://api.corenix.fr/v1/services

{ "success": true, "data": [ { "id": "XQW2MJG8", "name": "VPS-1", "status": "active", "ip": "82.29.39.3", "next_due": "2026-11-20", … } ] }

Disponibilité sur 7 jours

curl -H "Authorization: Bearer cxk_…" "https://api.corenix.fr/v1/services/XQW2MJG8/uptime?days=7"

Redémarrer un serveur écriture

curl -X POST -H "Authorization: Bearer cxk_…" -H "Content-Type: application/json" \
  -d '{"action":"reboot"}' https://api.corenix.fr/v1/services/XQW2MJG8/power

Modifier un reverse DNS écriture

curl -X PUT -H "Authorization: Bearer cxk_…" -H "Content-Type: application/json" \
  -d '{"hostname":"mail.exemple.fr"}' https://api.corenix.fr/v1/services/XQW2MJG8/ips/82.29.39.3/ptr

Python

import requests
API = "https://api.corenix.fr/v1"
H = {"Authorization": "Bearer cxk_…"}
for s in requests.get(f"{API}/services", headers=H, timeout=10).json()["data"]:
    print(s["id"], s["name"], s["status"])

PHP

$ch = curl_init('https://api.corenix.fr/v1/invoices?status=unpaid');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer cxk_…']]);
$factures = json_decode(curl_exec($ch), true)['data'];