API des commandes
L'API des commandes gère la création des commandes (publique, pour les clients) et la gestion des commandes (authentifiée, pour les restaurateurs). Le module complémentaire Ordering Suite doit être actif pour le restaurant.
POST /api/orders
Crée une nouvelle commande. Il s'agit d'un endpoint public utilisé par les clients qui passent commande depuis le menu.
Authentification : publique (aucun jeton requis)
Limite de débit : 5 requêtes par minute par IP
Corps de la requête
{
"restaurantId": "uuid",
"tableId": "uuid",
"items": [
{
"menuItemId": "uuid",
"quantity": 2
},
{
"menuItemId": "uuid",
"quantity": 1
}
]
}
Réponse (201 Created)
{
"success": true,
"data": {
"id": "uuid",
"status": "PENDING",
"tableLabel": "Table 5",
"items": [...],
"createdAt": "2026-02-19T14:30:00Z"
}
}
GET /api/orders
Récupère toutes les commandes de votre restaurant. Prend en charge le filtrage par statut.
Authentification : requise (jeton Bearer)
Paramètres de requête
status— Filtre par statut de commande (par ex.?status=PENDING)
Réponse (200 OK)
{
"success": true,
"data": [
{
"id": "uuid",
"status": "PENDING",
"tableLabel": "Table 5",
"items": [...],
"createdAt": "2026-02-19T14:30:00Z"
}
]
}
GET /api/orders/[id]
Récupère une seule commande. Cet endpoint prend en charge un double mode d'accès :
- Authentifié (propriétaire) : renvoie les données complètes de la commande, tous champs compris.
- Public (client) : renvoie un nombre limité de champs (statut, articles, libellé de la table). Nécessite le paramètre de requête
restaurantId.
PATCH /api/orders/[id]
Met à jour le statut d'une commande. Utilisé par les restaurateurs pour faire avancer les commandes dans leur cycle de vie.
Authentification : requise (jeton Bearer)
Corps de la requête
{
"status": "CONFIRMED"
}
Transitions de statut valides : PENDING vers CONFIRMED, CONFIRMED vers PREPARING, PREPARING vers READY, READY vers SERVED. Les commandes peuvent passer à CANCELLED depuis PENDING ou CONFIRMED.