Skip to main content
Les API Plato renvoient des messages d’erreur JSON lorsque cela est possible.

​
Forme d’erreur

Les points de terminaison REST renvoient généralement l’une de ces formes :
Lorsqu’une requête REST échoue, journalisez le statut HTTP, le corps de la réponse et l’identifiant de la requête.

​
Codes d’état courants

​
Limites de pagination

Différentes API exposent différents styles de pagination. Les points de terminaison de la liste CMS utilisent :
Les points de terminaison du menu utilisent :
Les opérations de liste Connect360 utilisent des curseurs :

​
Limites de flux de commande

Le flux de commandes du restaurant renvoie jusqu’à 50 commandes par demande. Les plages de dates peuvent aller jusqu’à 5 jours lorsque date et endDate sont fournies.

​
Conseils pour réessayer

Réessayez uniquement lorsque l’échec est temporaire. Réessayez :
  • Délais d’attente du réseau.
  • 429 après avoir attendu.
  • 500 ou 503 après un court délai.
Ne réessayez pas tant que ce n’est pas résolu :
  • Clé API invalide.
  • Autorisation manquante.
  • Champ inconnu.
  • Champ obligatoire manquant.
  • ID de relation invalide.

​
Idempotence

La création de commandes d’agrégateur est idempotente avec aggregator et externalOrderId, et accepte également l’en-tête Idempotency-Key. Les opérations d’écriture telles que la création de CMS, la soumission de formulaire et l’envoi de messages peuvent créer de nouveaux enregistrements à chaque fois qu’elles sont appelées. Rendez votre propre intégration idempotente lorsque des soumissions en double sont possibles.