> ## Documentation Index
> Fetch the complete documentation index at: https://docs.colismove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble — API Web SuperAdmin

> Référence des endpoints destinés à la console d'administration plateforme ColisMove

# API Web SuperAdmin

Cette section regroupe les endpoints utilisés par la **console d'administration** ColisMove. Elle permet aux super-administrateurs de gérer la plateforme de bout en bout.

Ces endpoints sont consommés par le portail web SuperAdmin (`admin.colismove.com`).

## URL de base

```
https://api.colismove.com/v1/api
```

## Capacités

La console SuperAdmin offre :

* **Gestion utilisateurs** : ban / unban, reset mot de passe, changement de rôle, historique
* **Modération KYC** : approbation manuelle, rejet, listing des dossiers en attente
* **Gestion réservations** : annulation administrative, résolution des litiges
* **Modération annonces** : suppression, mise en avant, activation/désactivation
* **Modération litiges & signalements** : review, résolution, rejet
* **Administration agences** : activation, suspension, validation KYC documents
* **Analytique** : tableaux de bord, KPIs (utilisateurs, réservations, annonces, transactions)
* **Configuration plateforme** : audit logs, paramètres globaux
* **Cache** : monitoring et invalidation des caches Caffeine / Redis

## Audiences distinctes

<CardGroup cols={3}>
  <Card title="Particuliers" icon="user" href="/api-reference/overview">
    Mobile + Web particuliers — expéditeurs / transporteurs
  </Card>

  <Card title="Web Agence" icon="building" href="/api-reference/overview-web-agency">
    Portail web pour agences professionnelles de transport
  </Card>

  <Card title="Web SuperAdmin" icon="shield" href="/api-reference/overview-superadmin">
    Console d'administration plateforme
  </Card>
</CardGroup>

## Modules API SuperAdmin

<CardGroup cols={2}>
  <Card title="Gestion utilisateurs" icon="users-gear" href="/api-reference/superadmin/list-users">
    Liste, détail, ban, unban, changement de rôle, reset mot de passe
  </Card>

  <Card title="Gestion KYC" icon="id-card" href="/api-reference/superadmin/list-kyc-pending">
    Approbation manuelle, rejet, modération des vérifications d'identité
  </Card>

  <Card title="Réservations" icon="ticket" href="/api-reference/superadmin/list-reservations">
    Liste, détail, annulation administrative, résolution de litiges
  </Card>

  <Card title="Annonces" icon="bullhorn" href="/api-reference/superadmin/list-annonces">
    Modération, suppression, mise en avant
  </Card>

  <Card title="Litiges" icon="gavel" href="/api-reference/superadmin/disputes/list">
    Review, résolution, rejet des litiges
  </Card>

  <Card title="Signalements" icon="flag" href="/api-reference/superadmin/reports/list">
    Modération des signalements utilisateurs
  </Card>

  <Card title="Administration agences" icon="building-shield" href="/api-reference/superadmin/agencies/activate">
    Activation, suspension, validation KYC agences
  </Card>

  <Card title="Analytique" icon="chart-line" href="/api-reference/superadmin/analytics/overview">
    KPIs et reporting de la plateforme
  </Card>

  <Card title="Configuration" icon="gear" href="/api-reference/superadmin/get-config">
    Audit logs, paramètres globaux
  </Card>

  <Card title="Cache" icon="database" href="/api-reference/cache/health">
    Monitoring et invalidation du cache
  </Card>
</CardGroup>

## Sécurité

Tous les endpoints SuperAdmin requièrent :

* Un token JWT valide (header `Authorization: Bearer <token>`)
* Le rôle `ROLE_SUPERADMIN`
* Toutes les actions sensibles sont **auditées** dans la table `audit_logs`