## Vue d'ensemble

Ces endpoints donnent un accès direct à votre compte WHM (Web Host Manager) pour gérer les comptes cPanel et les packages de votre infrastructure.

<Note>
  Ces endpoints nécessitent un **service revendeur actif avec accès WHM**. Deux erreurs sont possibles :
  - `no_reseller_service` (422) — pas de service revendeur actif avec accès WHM assigné
  - `whm_unavailable` (503) — WHM non disponible
</Note>

**Scope requis :** `reseller:hosting`

## Usage et quotas

```http
GET /api/v1/reseller/whm/usage
```

```json
{
  "success": true,
  "data": {
    "accounts_used": 3,
    "accounts_limit": 10,
    "disk_used_mb": 1536,
    "disk_limit_mb": 51200,
    "bandwidth_used_mb": 2048,
    "bandwidth_limit_mb": 102400
  }
}
```

## Lister les comptes cPanel

```http
GET /api/v1/reseller/whm/accounts
```

## Détail d'un compte

```http
GET /api/v1/reseller/whm/accounts/{username}
```

## Suspendre un compte

```http
POST /api/v1/reseller/whm/accounts/{username}/suspend
```

## Réactiver un compte

```http
POST /api/v1/reseller/whm/accounts/{username}/unsuspend
```

## Supprimer un compte

```http
DELETE /api/v1/reseller/whm/accounts/{username}
```

## Packages WHM

### Lister les packages

```http
GET /api/v1/reseller/whm/packages
```

### Créer un package

```http
POST /api/v1/reseller/whm/packages
```

```json
{
  "name": "mon-starter",
  "quota": 2048,
  "bandwidth": 10240,
  "maxsql": 10,
  "maxpop": 50,
  "maxftp": 5,
  "maxsub": 10
}
```

### Supprimer un package

```http
DELETE /api/v1/reseller/whm/packages/{name}
```

## Routes dépréciées

Les endpoints suivants sont maintenus pour la compatibilité. Migrez vers `/api/v1/reseller/whm/*`.

<Warning>
  Ces routes seront supprimées dans une prochaine version. Utilisez les endpoints `/api/v1/reseller/whm/*` documentés ci-dessus.
</Warning>

| Ancienne route | Nouvelle route |
|---------------|---------------|
| `GET /api/v1/reseller/accounts` | `GET /api/v1/reseller/whm/accounts` |
| `POST /api/v1/reseller/accounts` | `POST /api/v1/reseller/clients/{id}/hosting` |
| `GET /api/v1/reseller/packages` | `GET /api/v1/reseller/whm/packages` |
| `GET /api/v1/reseller/usage` | `GET /api/v1/reseller/whm/usage` |