Branchez votre site ou votre logiciel de facturation sur vos lots revendeur : une commande payée chez vous peut créer le VPS ou l'hébergement web de votre client, le suspendre s'il ne paie plus, et le connecter à son espace en un clic. L'API applique exactement les mêmes règles que votre espace revendeur (quotas, verrous, accès).
Module WHMCS : vendez vos VPS et vos hébergements depuis votre WHMCS (création au paiement, suspension des impayés, graphiques et connexion directe pour vos clients).
Télécharger le module WHMCS 1.2.0
Installation pas à pas dans le fichier LISEZMOI.md de l'archive.
- Adresse :
https://manager.korehost.fr/api/revendeur/v1
- Clé : créée dans votre espace revendeur, page « API » (lecture seule et adresses IP autorisées au choix), puis envoyée dans l'en-tête
Authorization: Bearer khr_….
- Format : JSON en entrée (
Content-Type: application/json) et en sortie. Les résultats sont dans donnees, les messages dans message.
- Erreurs : 401 clé invalide · 403 IP non autorisée ou clé en lecture seule · 404 introuvable (ou pas à vous) · 422 refus (quota, lot suspendu, champ invalide : détail dans
errors) · 429 trop d'appels.
- Limite : 60 appels par minute et par clé (en-têtes
X-RateLimit-Remaining et Retry-After).
- Valeurs illimitées : dans un lot web illimité, 0 veut dire illimité pour les sites, les e-mails et les bases.
Compte et lots
| GET |
/moi |
Votre compte, votre marque et la clé utilisée. |
| GET |
/lots |
Vos lots (type vps ou web) avec leur quota, ce qui est utilisé et ce qui reste. |
| GET |
/lots/{id} |
Un lot. |
| GET |
/systemes |
Systèmes disponibles pour un VPS (champ « systeme »). |
VPS (lots revendeur VPS)
| GET |
/vps |
Vos VPS ; filtres facultatifs ?lot= et ?client=. |
| GET |
/vps/{id} |
Un VPS : statut, IP, ressources, opération en cours, identifiant et mot de passe root. |
| POST |
/lots/{id}/vps |
Crée un VPS : nom, systeme, vcpu, ram_mo, disque_go, client_id (facultatif). Réponse 202 : création en 1 à 3 minutes. |
| PATCH |
/vps/{id} |
Change vcpu, ram_mo et/ou disque_go (le disque ne fait que grandir). Réponse 202. |
| DELETE |
/vps/{id} |
Supprime le VPS et ses données. Réponse 202. |
| POST |
/vps/{id}/alimentation |
action : start, stop, shutdown ou reboot. |
| POST |
/vps/{id}/reinstaller |
Réinstalle le VPS avec systeme (même famille : LXC ou KVM, voir /systemes). Efface toutes ses données, garde son IP et ses ressources. Réponse 202 : 1 à 5 minutes, nouveau mot de passe root sur GET /vps/{id}. |
| POST |
/vps/{id}/mot-de-passe |
Nouveau mot de passe root, renvoyé dans la réponse (le VPS doit être démarré). |
| GET |
/vps/{id}/statistiques |
Historique pour vos graphiques : CPU (%), RAM (Mo), disque (Go), réseau entrant et sortant (Ko/s). ?periode= heure (un point par minute, par défaut), jour, semaine, mois ou annee. |
| POST |
/vps/{id}/console |
Console du VPS dans le navigateur : adresse WebSocket signée (url), à ouvrir dans la minute (le VPS doit être démarré). Texte envoyé = touches tapées, texte reçu = écran ; « \x1b]RESIZE;COLONNES;LIGNES\x07 » redimensionne. Le module WHMCS s'en sert avec xterm.js. |
Hébergements web (lots revendeur web)
| GET |
/hebergements |
Vos hébergements ; filtres facultatifs ?lot= et ?client=. |
| GET |
/hebergements/{id} |
Un hébergement, avec ses sites, ses accès FTP et ses bases de données. |
| POST |
/lots/{id}/hebergements |
Crée un hébergement : nom, disque_go, sites, emails, bases, client_id (facultatif). Réponse 201 : le site est déjà en ligne. |
| PATCH |
/hebergements/{id} |
Change disque_go, sites, emails et/ou bases (champs absents inchangés). |
| DELETE |
/hebergements/{id} |
Supprime l'hébergement : sites, fichiers, e-mails, bases et sauvegardes. |
Suspension et attribution (type = vps ou hebergements)
| POST |
/{type}/{id}/suspendre |
Suspend le service : il reste suspendu, même au renouvellement du lot, jusqu'à sa réactivation. |
| POST |
/{type}/{id}/reactiver |
Réactive le service. |
| PUT |
/{type}/{id}/client |
Attribue le service à un client (client_id), ou le retire (client_id: null). |
Clients
| GET |
/clients |
Vos clients. |
| GET |
/clients/{id} |
Un client et la liste de ses services. |
| POST |
/clients |
Crée un client (nom, email) et lui envoie son invitation. |
| DELETE |
/clients/{id} |
Supprime l'accès du client ; ses services restent dans vos lots. |
| POST |
/clients/{id}/invitation |
Renvoie l'e-mail d'invitation. |
| POST |
/clients/{id}/connexion |
Lien de connexion directe (5 minutes, une seule fois) ; vers (facultatif) : page de destination commençant par /client/. |
Exemples
Lister vos lots
curl -s https://manager.korehost.fr/api/revendeur/v1/lots \
-H "Authorization: Bearer khr_VOTRE_CLE"
Créer un client
curl -s -X POST https://manager.korehost.fr/api/revendeur/v1/clients \
-H "Authorization: Bearer khr_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"nom": "Boulangerie Dupont", "email": "contact@boulangerie-dupont.fr"}'
Créer un hébergement web pour ce client
curl -s -X POST https://manager.korehost.fr/api/revendeur/v1/lots/34/hebergements \
-H "Authorization: Bearer khr_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"nom": "Boulangerie Dupont", "disque_go": 5, "sites": 1, "emails": 10, "bases": 1, "client_id": 57}'
Créer un VPS
curl -s -X POST https://manager.korehost.fr/api/revendeur/v1/lots/12/vps \
-H "Authorization: Bearer khr_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"nom": "vps-dupont", "systeme": "korehost-debian-12", "vcpu": 2, "ram_mo": 2048, "disque_go": 20}'
Statistiques d'un VPS sur 24 heures (graphiques)
curl -s "https://manager.korehost.fr/api/revendeur/v1/vps/1234/statistiques?periode=jour" \
-H "Authorization: Bearer khr_VOTRE_CLE"
# réponse : {"donnees": {"periode": "jour", "vcpu": 2, "ram_mo": 2048, "points": [{"heure": "…", "cpu_pourcent": 3.2, "ram_mo": 412.5, "disque_go": 1.84, "reseau_entrant_ko_s": 12.4, "reseau_sortant_ko_s": 3.1}, …]}}
Réinstaller un VPS
curl -s -X POST https://manager.korehost.fr/api/revendeur/v1/vps/1234/reinstaller \
-H "Authorization: Bearer khr_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{"systeme": "korehost-debian-12"}'
Suspendre un hébergement impayé
curl -s -X POST https://manager.korehost.fr/api/revendeur/v1/hebergements/88/suspendre \
-H "Authorization: Bearer khr_VOTRE_CLE"
Connecter votre client à son espace en un clic
curl -s -X POST https://manager.korehost.fr/api/revendeur/v1/clients/57/connexion \
-H "Authorization: Bearer khr_VOTRE_CLE"
# réponse : {"donnees": {"url": "https://manager.korehost.fr/connexion-revendeur/57?…", "expire_le": "…"}}
