## 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.

<Note>
  L'accès à l'API Revendeurs nécessite un **service revendeur actif**. Gérez vos tokens depuis votre [espace client → Développeur](https://kennhosting.com/client/developer).
</Note>

## 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

<CardGroup cols={2}>
  <Card title="Clients" icon="users">
    Créer et gérer les comptes de vos propres clients. Live : compte KennHosting créé. Sandbox : fictif, sans User réel.
  </Card>
  <Card title="Hébergement Web" icon="server">
    Provisionner des comptes cPanel depuis votre quota WHM. Le domaine est obligatoire — l'enregistrement est optionnel.
  </Card>
  <Card title="Domaines" icon="globe">
    Vérifier la disponibilité et enregistrer des domaines. Le wallet est débité au prix de gros.
  </Card>
  <Card title="VPS" icon="microchip">
    Commander des VPS cloud pour vos clients. Débit wallet immédiat, provision asynchrone avec webhook de confirmation.
  </Card>
  <Card title="Email Pro" icon="mail">
    Activer des boîtes email professionnelles sous les domaines de vos clients.
  </Card>
  <Card title="Wallet" icon="wallet">
    Consulter vos soldes live/sandbox, voir l'historique des transactions, recharger en ligne.
  </Card>
  <Card title="Webhooks" icon="webhook">
    Recevoir des notifications en temps réel pour chaque événement (provision, activation, expiration).
  </Card>
  <Card title="Branding Email" icon="palette">
    Les emails envoyés à vos clients portent votre logo, vos couleurs et votre nom d'expéditeur.
  </Card>
</CardGroup>

## URL de base

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

## Format des réponses

Toutes les réponses suivent la structure standard KennHosting :

```json
{
  "success": true,
  "data": { ... },
  "meta": {
    "pagination": {
      "total": 42,
      "per_page": 50,
      "current_page": 1,
      "last_page": 1
    }
  }
}
```

En cas d'erreur :

```json
{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Solde insuffisant dans le wallet live."
  }
}
```

## Codes d'erreur spécifiques revendeurs

| Code | HTTP | Description |
|------|------|-------------|
| `insufficient_balance` | 422 | Solde wallet insuffisant |
| `invalid_plan` | 422 | Plan introuvable ou inactif |
| `quota_exceeded` | 422 | Quota WHM dépassé |
| `whm_unavailable` | 503 | WHM non configuré ou hors-ligne |
| `domain_unavailable` | 422 | Domaine non disponible à l'enregistrement |
| `duplicate_email` | 422 | Email déjà utilisé pour un client |
| `email_taken` | 422 | Email déjà utilisé sur KennHosting |
| `has_services` | 422 | Client possède des services actifs (suppression bloquée) |
| `client_no_account` | 422 | Client sandbox sans compte KH live |
| `sandbox_only` | 403 | Action réservée aux tokens sandbox |
| `sandbox_read_only` | 403 | Action d'écriture non autorisée (ancienne contrainte) |
| `forbidden` | 403 | Scope manquant |