​
Vue d’ensemble

La provision VPS débite votre wallet immédiatement. Le serveur est créé de façon asynchrone — vous recevez un webhook vps.activated lorsqu’il est opérationnel. Scope requis : reseller:vps

​
Plans disponibles

Consultez /api/v1/reseller/catalog (catégorie vps) pour les slugs courants :
SlugPrix (XAF/an)
vps-start45 000
vps-pro85 000
vps-scale145 000

​
Commander un VPS

POST /api/v1/reseller/clients/{client_id}/vps
Corps de la requête :
ChampTypeRequisDescription
plan_slugstringOuiSlug du plan VPS (ex. vps-start)
locationstringOuiDatacenter cible (ex. eu-west, eu-central) — voir la liste ci-dessous
os_imagestringOuiImage OS (ex. ubuntu-22.04, debian-12)
hostnamestringNonNom du serveur
curl -X POST "https://kennhosting.com/api/v1/reseller/clients/1/vps" \
  -H "Authorization: Bearer kh_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_slug": "vps-start",
    "location": "eu-west",
    "os_image": "ubuntu-24-04",
    "hostname": "jean-serveur"
  }'
Réponse live (201) : 
{
  "success": true,
  "data": {
    "sandbox": false,
    "client_id": 1,
    "order_uuid": "b1912d95-a2b5-479b-9b19-ee8048e24776",
    "plan": "vps-start",
    "status": "provisioning",
    "amount_debited": 45000,
    "message": "Le VPS est en cours de création. Vous recevrez un webhook lorsqu'il sera actif."
  }
}
Réponse sandbox (201) : 
{
  "success": true,
  "data": {
    "sandbox": true,
    "client_id": 1,
    "plan": "vps-start",
    "server_id": "sb_jHvJBFwk",
    "server_name": "jean-serveur",
    "location": "eu-west",
    "os_image": "ubuntu-24-04",
    "ipv4": "0.0.0.0",
    "status": "running",
    "amount_debited": 45000,
    "message": "VPS sandbox simulé — aucun serveur réel créé."
  }
}

​
Consulter un VPS

GET /api/v1/reseller/clients/{client_id}/vps/{service_uuid}

​
Actions d’alimentation

POST /api/v1/reseller/clients/{client_id}/vps/{service_uuid}/{action}
Actions disponibles : reboot, power-on, power-off

​
Supprimer un VPS

DELETE /api/v1/reseller/clients/{client_id}/vps/{service_uuid}

​
Datacenters disponibles

CodeLocalisation
eu-westEurope Ouest
eu-centralEurope Centrale
eu-northEurope Nord

​
Images OS courantes

  • ubuntu-22-04
  • ubuntu-24-04
  • debian-12
  • centos-stream-9

​
Webhook VPS

Quand le serveur est actif, KennHosting envoie : 
{
  "event": "vps.activated",
  "sandbox": false,
  "data": {
    "order_uuid": "b1912d95-...",
    "client_id": 1,
    "server_id": 12345,
    "ipv4": "1.2.3.4",
    "status": "running"
  }
}