Ce fichier décrit le WebSocket de notifications temps réel de DiddiFood. Il s'adresse aux applications client/Pro et aux équipes qui implémentent la reconnexion.

Connexion

wss://<food-host>/food/v1/ws?token=<JWT humain> accepte un JWT DiddiFreeID dans la query string. Un token invalide ferme la socket avec le code 4401. Il n'existe actuellement aucun événement client vers serveur.

Événements serveur vers client

Tous les événements utilisent le même enveloppe :

{
  "event": "order.ready",
  "title": "Commande prête",
  "body": "Votre commande est prête.",
  "data": {
    "event": "order.ready",
    "at": "2026-10-21T12:00:00Z",
    "order_id": "uuid"
  }
}

Les événements métier réellement appelés sont order.accepted, order.ready, order.delivered, order.cancelled, payment.succeeded, payment.failed et les événements de substitution quand cette fonction est activée. Le champ data contient les identifiants et valeurs nécessaires au client; le serveur ne rejoue pas les événements manqués.