API
Endpoints
Référence des principaux endpoints de l'API Swaloo.
Endpoints API
Base URL : https://api.swaloo.com/api/v1
Expéditions
| Méthode | Endpoint | Description |
|---|---|---|
GET | /shipments | Lister les expéditions |
POST | /shipments | Créer une expédition |
GET | /shipments/{id} | Détail d'une expédition |
PATCH | /shipments/{id} | Modifier une expédition |
DELETE | /shipments/{id} | Supprimer un brouillon |
Chauffeurs
| Méthode | Endpoint | Description |
|---|---|---|
GET | /drivers | Lister les chauffeurs |
GET | /drivers/{id} | Détail d'un chauffeur |
GET | /drivers/{id}/tasks | Tâches d'un chauffeur |
Tournées
| Méthode | Endpoint | Description |
|---|---|---|
GET | /routes | Lister les tournées |
POST | /routes | Créer une tournée |
POST | /routes/optimize | Optimiser une tournée |
Suivi
| Méthode | Endpoint | Description |
|---|---|---|
GET | /tracking/{code} | Suivi public par code |
GET | /shipments/{id}/events | Historique des événements |
Pagination
Tous les endpoints de liste supportent la pagination :
GET /shipments?page=1&itemsPerPage=30Réponse avec métadonnées Hydra :
{
"hydra:totalItems": 142,
"hydra:member": [...]
}Filtres
Utilisez les query parameters pour filtrer :
GET /shipments?status=in_transit&createdAt[after]=2024-01-01La documentation interactive complète est disponible sur /api/docs (Swagger UI).
Voir aussi : Authentification | Erreurs