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

> Référence des endpoints utilisés par les utilisateurs particuliers (expéditeurs et transporteurs), via l'application mobile ou le site web

# API Particuliers

Cette section regroupe l'ensemble des endpoints destinés aux **utilisateurs particuliers** : expéditeurs et transporteurs.

Ces endpoints sont consommés par :

* L'**application mobile** ColisMove (iOS / Android — Flutter)
* Le **site web** particuliers (Next.js — `app.colismove.com`)

Les deux clients utilisent le même contrat API, avec un comportement identique.

## URL de base

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

## Audiences distinctes

L'API ColisMove est segmentée selon trois audiences :

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

<CardGroup cols={2}>
  <Card title="Authentification" icon="lock" href="/api-reference/auth/register">
    Inscription, connexion, OAuth2 Google/Apple, réinitialisation mot de passe, gestion des tokens
  </Card>

  <Card title="Utilisateurs" icon="user" href="/api-reference/users/get-current-user">
    Gestion du profil, informations du portefeuille
  </Card>

  <Card title="Annonces" icon="bullhorn" href="/api-reference/announcements/list">
    CRUD des annonces de transport, recherche, historique
  </Card>

  <Card title="Réservations" icon="ticket" href="/api-reference/bookings/create">
    Cycle de vie complet : création, acceptation, refus, annulation, validation
  </Card>

  <Card title="Paiements" icon="credit-card" href="/api-reference/payments/create-checkout">
    Sessions Stripe Checkout et statut des paiements
  </Card>

  <Card title="Stripe Connect" icon="stripe" href="/api-reference/stripe-connect/start-onboarding">
    Onboarding transporteurs pour recevoir des paiements
  </Card>

  <Card title="Transactions" icon="money-bill-transfer" href="/api-reference/transactions/history">
    Historique financier, revenus, dépenses, résumés
  </Card>

  <Card title="Retraits" icon="money-bill-wave" href="/api-reference/withdrawals/request">
    Demandes de retrait du portefeuille et configuration retrait automatique
  </Card>

  <Card title="KYC" icon="id-card" href="/api-reference/kyc/init-verification">
    Vérification d'identité via Didit V2
  </Card>

  <Card title="Notifications" icon="bell" href="/api-reference/notifications/list">
    Gestion des notifications push (FCM)
  </Card>

  <Card title="Avis" icon="star" href="/api-reference/reviews/create">
    Notation et avis post-livraison
  </Card>

  <Card title="QR Codes" icon="qrcode" href="/api-reference/qrcode/generate">
    Validation dépôt et livraison via QR codes
  </Card>

  <Card title="Suivi GPS" icon="location-dot" href="/api-reference/tracking/start">
    Suivi temps réel de la position du transporteur
  </Card>

  <Card title="Messagerie" icon="message" href="/api-reference/messaging/overview">
    Messagerie temps réel via Firestore
  </Card>
</CardGroup>

## Spécification OpenAPI

La spécification OpenAPI 3.0 complète est disponible :

* **JSON** : [`/v3/api-docs`](https://api.colismove.com/v3/api-docs)
* **Swagger UI** : [`/swagger/swagger-ui.html`](https://api.colismove.com/swagger/swagger-ui.html)