Retour à la connexion

E

API Ekolo

Référence des endpoints de l'API REST Ekolo. Base URL: http://localhost:8000

Auth

Méthode	Endpoint	Description	Payload	Auth
POST	/api/auth/login	Authentifier un utilisateur (email, password, client_type)	email, password, client_type (dashboard\|mobile)
POST	/api/auth/register	Créer un compte utilisateur	name, email, password, password_confirmation, role?, language?, organization?
POST	/api/auth/forgot-password	Demander un lien de réinitialisation	email
POST	/api/auth/logout	Révoquer le token courant	—
GET	/api/auth/me	Profil de l'utilisateur connecté	—
PATCH	/api/auth/me	Mettre à jour son profil (name, phone, organization, language)	name?, phone?, organization?, language?

Contact

Méthode	Endpoint	Description	Payload	Auth
POST	/api/contact	Envoyer un message de contact	subject, message

Dashboard

Méthode	Endpoint	Description	Payload	Auth
GET	/api/dashboard/kpis	Indicateurs clés de performance	—
GET	/api/dashboard/summary	Résumé opérationnel	—
GET	/api/dashboard/active-tours	Tournées en cours	—
GET	/api/dashboard/alerts	Alertes récentes	—

Analytics

Méthode	Endpoint	Description	Payload	Auth
GET	/api/analytics/fuel-trends	Historique carburant / économies	—
GET	/api/analytics/waste-categories	Répartition par type de déchet	—
GET	/api/analytics/productivity	Top 10 productivité des agents	—
GET	/api/analytics/weekly-collection	Collecte hebdomadaire	—
GET	/api/analytics/forecast	Prévisions	—

Tâches (Tasks)

Méthode	Endpoint	Description	Payload	Auth
GET	/api/tasks	Lister les tâches (filtres: status, priority, profile_id)	—
POST	/api/tasks	Créer une tâche	title, profile_id, waste_site_id, priority?, deadline?, description?, notes?
GET	/api/tasks/{id}	Détail d'une tâche	—
PUT	/api/tasks/{id}	Modifier une tâche	—
DELETE	/api/tasks/{id}	Supprimer une tâche	—
PATCH	/api/tasks/{id}/status	Changer le statut	status (pending\|in-progress\|completed\|cancelled)
POST	/api/tasks/{id}/accept	Accepter / prendre en charge	—
POST	/api/tasks/{id}/start-route	Démarrer la tournée	—

Sites de déchets (Waste Sites)

Méthode	Endpoint	Description	Payload	Auth
GET	/api/waste-sites	Lister les sites	—
POST	/api/waste-sites	Créer un site	name, lat, lng, type, severity?, description?
GET	/api/waste-sites/{id}	Détail d'un site	—
PUT	/api/waste-sites/{id}	Modifier un site	—
DELETE	/api/waste-sites/{id}	Supprimer un site	—
GET	/api/waste-sites/type-counts	Nombre de sites par type	—
PATCH	/api/waste-sites/{id}/assign	Assigner à un agent	profile_id
PATCH	/api/waste-sites/{id}/resolve	Marquer comme résolu	—

Tournées (Routes)

Méthode	Endpoint	Description	Payload	Auth
GET	/api/routes	Lister les tournées	—
POST	/api/routes	Créer une tournée	name, driver_id?, distance_km?, stops?, eta?, polyline?
GET	/api/routes/{id}	Détail d'une tournée	—
PUT	/api/routes/{id}	Modifier une tournée	—
DELETE	/api/routes/{id}	Supprimer une tournée	—
GET	/api/routes/summary	Résumé des tournées	—
PATCH	/api/routes/{id}/status	Changer le statut	status

Véhicules

Méthode	Endpoint	Description	Payload	Auth
GET	/api/vehicles	Lister les véhicules	—
POST	/api/vehicles	Créer un véhicule	plate, status?, fuel_level?, driver_id?, zone?, health?, capacity?, model?, year?
GET	/api/vehicles/{id}	Détail d'un véhicule	—
PUT	/api/vehicles/{id}	Modifier un véhicule	—
DELETE	/api/vehicles/{id}	Supprimer un véhicule	—
PATCH	/api/vehicles/{id}/status	Changer le statut	status
PATCH	/api/vehicles/{id}/assign-driver	Assigner un chauffeur	profile_id

Profils agents

Méthode	Endpoint	Description	Payload	Auth
GET	/api/profiles	Lister les profils agents	—
GET	/api/profiles/status-counts	Nombre d'agents par statut	—
GET	/api/profiles/{id}	Détail d'un profil	—
PATCH	/api/profiles/{id}/status	Changer le statut	status (available\|on-task\|break\|offline\|emergency)
PATCH	/api/profiles/{id}/position	Mettre à jour la position GPS	lat, lng, battery?
GET	/api/profiles/{id}/tracking	Dernière position connue	—

Agent Mobile

Méthode	Endpoint	Description	Payload	Auth
GET	/api/agent/stats	Statistiques de l'agent connecté	—
GET	/api/agent/tasks	Tâches assignées à l'agent	—
GET	/api/agent/missions/active	Mission en cours	—
POST	/api/agent/complete-mission	Finaliser une mission (avec images)	task_id, notes?, images[] (fichiers)
GET	/api/agent/performance	Indicateurs de performance	—
PATCH	/api/agent/status	Changer son statut	status

Achievements

Méthode	Endpoint	Description	Payload	Auth
GET	/api/achievements	Lister les achievements	—
POST	/api/achievements	Créer un achievement	profile_id, type, title, description?, icon?, earned_at?
GET	/api/achievements/{id}	Détail d'un achievement	—
PUT	/api/achievements/{id}	Modifier	—
DELETE	/api/achievements/{id}	Supprimer	—

Signalements (Issue Reports)

Méthode	Endpoint	Description	Payload	Auth
GET	/api/issue-reports	Lister les signalements	—
POST	/api/issue-reports	Créer un signalement	title, description?, lat?, lng?, images?, status?
GET	/api/issue-reports/{id}	Détail d'un signalement	—
PUT	/api/issue-reports/{id}	Modifier	—
DELETE	/api/issue-reports/{id}	Supprimer	—

Notifications

Méthode	Endpoint	Description	Payload	Auth
GET	/api/notifications	Lister les notifications	—
GET	/api/notifications/unread-count	Nombre de notifications non lues	—
GET	/api/notifications/{id}	Détail d'une notification	—
PATCH	/api/notifications/{id}/read	Marquer comme lue	—
PATCH	/api/notifications/read-all	Tout marquer comme lu	—
DELETE	/api/notifications/{id}	Supprimer une notification	—
DELETE	/api/notifications/clear	Vider toutes les notifications	—

Carburant (Fuel Logs)

Méthode	Endpoint	Description	Payload	Auth
GET	/api/fuel-logs	Lister les relevés carburant	—
POST	/api/fuel-logs	Ajouter un relevé	vehicle_id, amount, cost, date?, odometer?, filled_by?
GET	/api/fuel-logs/{id}	Détail d'un relevé	—
PUT	/api/fuel-logs/{id}	Modifier	—
DELETE	/api/fuel-logs/{id}	Supprimer	—

Maintenance

Méthode	Endpoint	Description	Payload	Auth
GET	/api/maintenance-records	Lister les entretiens	—
POST	/api/maintenance-records	Planifier un entretien	vehicle_id, type, description?, scheduled_at?, completed_at?, cost?, notes?
GET	/api/maintenance-records/{id}	Détail d'un entretien	—
PUT	/api/maintenance-records/{id}	Modifier	—
DELETE	/api/maintenance-records/{id}	Supprimer	—

Rapports

Méthode	Endpoint	Description	Payload	Auth
GET	/api/reports	Lister les rapports	—
POST	/api/reports	Générer un rapport	title, type?, period_start?, period_end?, ai_generated?
GET	/api/reports/{id}	Détail d'un rapport	—
PUT	/api/reports/{id}	Modifier	—
DELETE	/api/reports/{id}	Supprimer	—

IA (AI)

Méthode	Endpoint	Description	Payload	Auth
GET	/api/ai/executive-summary	Résumé exécutif (Cloudflare AI requis)	—
GET	/api/ai/insights	Insights opérationnels	—
GET	/api/ai/detect-anomalies	Détection d'anomalies	—
POST	/api/ai/chat	Assistant IA (contexte Ekolo)	message, conversation_id?
POST	/api/ai/chat/public	Assistant IA (sans contexte)	message
POST	/api/ai/analyze-costs	Analyse des coûts	—
POST	/api/ai/forecast-waste	Prévision des déchets	—
POST	/api/ai/optimize-routes	Optimisation de tournées	—
GET	/api/ai/conversations	Historique des conversations	—
GET	/api/ai/conversations/{id}	Messages d'une conversation	—
DELETE	/api/ai/conversations/{id}	Supprimer une conversation	—

Fichiers

Méthode	Endpoint	Description	Payload	Auth
POST	/api/uploads	Uploader un fichier (image, PDF, etc.)	file (multipart), collection (waste_site\|report\|employee\|vehicle\|issue), model_id?