## Vue d'ensemble

Le catalogue liste tous les plans actifs de KennHosting, regroupés par catégorie. C'est la source de vérité pour les slugs à utiliser lors de la provision.

**Scope requis :** `reseller:catalog`

## Lister le catalogue

```http
GET /api/v1/reseller/catalog
```

**Réponse :**

```json
{
  "success": true,
  "data": {
    "essential": [
      {
        "id": 1,
        "slug": "starter",
        "name": "STARTER",
        "category": "essential",
        "price": "25000.00",
        "reseller_price": null,
        "billing_period": "annual",
        "description": "...",
        "features": { ... }
      }
    ],
    "vps": [
      {
        "id": 9,
        "slug": "vps-start",
        "name": "VPS START",
        "category": "vps",
        "price": "45000.00",
        "reseller_price": null,
        "billing_period": "annual"
      }
    ],
    "email": [
      {
        "id": 19,
        "slug": "email-solo",
        "name": "Email Solo",
        "category": "email",
        "price": "12000.00",
        "reseller_price": null,
        "billing_period": "annual",
        "features": {
          "max_mailboxes": 1,
          "quota_mb": 15360
        }
      }
    ]
  }
}
```

<Note>
  `reseller_price` est le prix de gros que KennHosting vous facture (débité de votre wallet). Si `null`, le prix normal `price` s'applique. Vous fixez librement le prix que vous facturez à vos clients.
</Note>

## Détail d'un plan

```http
GET /api/v1/reseller/catalog/{slug}
```

```bash
curl "https://kennhosting.com/api/v1/reseller/catalog/vps-start" \
  -H "Authorization: Bearer kh_live_YOUR_TOKEN" \
  -H "Accept: application/json"
```

**Réponse :**

```json
{
  "success": true,
  "data": {
    "id": 9,
    "slug": "vps-start",
    "name": "VPS START",
    "category": "vps",
    "price": "45000.00",
    "reseller_price": null,
    "billing_period": "annual"
  }
}
```

## Catégories disponibles

| Catégorie | Plans inclus |
|-----------|-------------|
| `essential` | Hébergement web partagé (STARTER, PRO...) |
| `advanced` | Hébergement avancé (START, PRO, SCALE) |
| `reseller` | Plans revendeur WHM (NANO, STARTER...) |
| `vps` | VPS cloud (vps-start, vps-pro, vps-scale) |
| `email` | Email Pro (email-solo, email-pro-plan, email-business) |
| `domain` | Enregistrement de domaines |

## Slugs courants

| Service | Slug |
|---------|------|
| Hébergement Starter | `starter` |
| Hébergement Pro | `pro` |
| VPS Start | `vps-start` |
| VPS Pro | `vps-pro` |
| VPS Scale | `vps-scale` |
| Email Solo (1 boîte) | `email-solo` |
| Email Pro (5 boîtes) | `email-pro-plan` |
| Email Business (illimité) | `email-business` |