Skip to main content

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 :

Particuliers

Mobile + Web particuliers — expéditeurs / transporteurs

Web Agence

Portail web pour agences professionnelles de transport

Web SuperAdmin

Console d’administration plateforme

Modules API Particuliers

Authentification

Inscription, connexion, OAuth2 Google/Apple, réinitialisation mot de passe, gestion des tokens

Utilisateurs

Gestion du profil, informations du portefeuille

Annonces

CRUD des annonces de transport, recherche, historique

Réservations

Cycle de vie complet : création, acceptation, refus, annulation, validation

Paiements

Sessions Stripe Checkout et statut des paiements

Stripe Connect

Onboarding transporteurs pour recevoir des paiements

Transactions

Historique financier, revenus, dépenses, résumés

Retraits

Demandes de retrait du portefeuille et configuration retrait automatique

KYC

Vérification d’identité via Didit V2

Notifications

Gestion des notifications push (FCM)

Avis

Notation et avis post-livraison

QR Codes

Validation dépôt et livraison via QR codes

Suivi GPS

Suivi temps réel de la position du transporteur

Messagerie

Messagerie temps réel via Firestore

Spécification OpenAPI

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