Documentation API
Endpoint : Mise à jour du statut d'une commande
URL
https://sahladelivery.com/commande/api_update_commande_status.php
Méthode HTTP
PUT
Description
Cette API permet de mettre à jour le statut d'une commande.
Elle gère également la création et la mise à jour des notifications des livreurs selon le statut.
Headers requis
| Header |
Valeur |
| Content-Type |
application/json |
Body (JSON)
{
"commande_id": 15,
"status": "refus"
}
Exemples complets
➡️ Exemple 1 : Mettre en préparation
{
"commande_id": 15,
"status": "prepare"
}
➡️ Exemple 2 : Marquer comme terminée
{
"commande_id": 15,
"status": "termine"
}
➡️ Exemple 3 : Marquer comme livrée
{
"commande_id": 15,
"status": "livree"
}
➡️ Exemple 4 : Refuser la commande
{
"commande_id": 15,
"status": "refus"
}
Paramètres
| Nom |
Type |
Obligatoire |
Description |
| commande_id |
Integer |
Oui |
ID de la commande à modifier |
| status |
String |
Oui |
Nouveau statut de la commande |
Statuts autorisés
| Statut |
Description |
Effet système |
| en_attente |
Commande créée |
Aucune action spécifique |
| prepare |
Commande en préparation |
Création automatique d'une notification livreur si inexistante |
| termine |
Commande prête |
Mise à jour du statut de la notification livreur → termine |
| livree |
Commande livrée |
Mise à jour du statut de la notification livreur → livree |
| refus |
Commande refusée |
Aucune logique supplémentaire actuellement (réservé pour future gestion) |
Réponses
✅ Succès (200)
{
"success": true,
"message": "Status mis à jour avec succès."
}
❌ Erreur 400 - Paramètres manquants
{
"success": false,
"message": "commande_id et status sont obligatoires."
}
❌ Erreur 404 - Commande introuvable
{
"success": false,
"message": "Commande introuvable."
}
❌ Erreur 405 - Mauvaise méthode
{
"success": false,
"message": "Méthode non autorisée. Utilisez PUT."
}
❌ Erreur 500 - Erreur serveur
{
"success": false,
"message": "Erreur serveur."
}
Remarques importantes
- La méthode doit être PUT.
- Le body doit être envoyé en JSON.
- Les statuts déclenchent des actions automatiques côté serveur.
- Le statut refus est déjà supporté mais sans logique métier associée pour le moment.
- L'API supporte CORS.