​
Qu’est-ce que l’API White-Label ?

L’API Revendeurs KennHosting vous permet de construire votre propre plateforme d’hébergement sous votre marque, en utilisant l’infrastructure KennHosting. Vous gérez vos clients, provisionnez leurs services et contrôlez leur expérience — sans qu’ils voient jamais KennHosting.
L’accès à l’API Revendeurs nécessite un service revendeur actif. Gérez vos tokens depuis votre espace client → Développeur.

​
Modèle de fonctionnement

Votre client → Votre site → API KennHosting → Infrastructure réelle
                               ↓
                    Wallet revendeur débité
                    (prix de gros KennHosting)
                               ↓
                    Vous facturez votre client
                    (votre propre prix)
Ce que vous contrôlez :
  • Vos prix clients (vous fixez vos marges)
  • Le branding email (logo, couleurs, expéditeur)
  • Les noms de vos offres
Ce que KennHosting gère :
  • L’infrastructure (serveurs, domaines, emails)
  • Les déductions sur votre wallet au prix de gros
  • La livraison des services

​
Capacités de l’API

Clients

Créer et gérer les comptes de vos propres clients. Live : compte KennHosting créé. Sandbox : fictif, sans User réel.

Hébergement Web

Provisionner des comptes cPanel depuis votre quota WHM. Le domaine est obligatoire — l’enregistrement est optionnel.

Domaines

Vérifier la disponibilité et enregistrer des domaines. Le wallet est débité au prix de gros.

VPS

Commander des VPS cloud pour vos clients. Débit wallet immédiat, provision asynchrone avec webhook de confirmation.

Email Pro

Activer des boîtes email professionnelles sous les domaines de vos clients.

Wallet

Consulter vos soldes live/sandbox, voir l’historique des transactions, recharger en ligne.

Webhooks

Recevoir des notifications en temps réel pour chaque événement (provision, activation, expiration).

Branding Email

Les emails envoyés à vos clients portent votre logo, vos couleurs et votre nom d’expéditeur.

​
URL de base

https://kennhosting.com/api/v1/reseller

​
Format des réponses

Toutes les réponses suivent la structure standard KennHosting : 
{
  "success": true,
  "data": { ... },
  "meta": {
    "pagination": {
      "total": 42,
      "per_page": 50,
      "current_page": 1,
      "last_page": 1
    }
  }
}
En cas d’erreur : 
{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Solde insuffisant dans le wallet live."
  }
}

​
Codes d’erreur spécifiques revendeurs

CodeHTTPDescription
insufficient_balance422Solde wallet insuffisant
invalid_plan422Plan introuvable ou inactif
quota_exceeded422Quota WHM dépassé
whm_unavailable503WHM non configuré ou hors-ligne
domain_unavailable422Domaine non disponible à l’enregistrement
duplicate_email422Email déjà utilisé pour un client
email_taken422Email déjà utilisé sur KennHosting
has_services422Client possède des services actifs (suppression bloquée)
client_no_account422Client sandbox sans compte KH live
sandbox_only403Action réservée aux tokens sandbox
sandbox_read_only403Action d’écriture non autorisée (ancienne contrainte)
forbidden403Scope manquant