Aller au contenu principal

Référence de l'API

Codes d'erreur

Codes d'erreur

Les endpoints de l'API MenuGaze renvoient des codes de statut HTTP standard. Les réponses d'erreur incluent un corps JSON détaillant le problème rencontré.

Format des réponses d'erreur

{
  "success": false,
  "error": "Human-readable error message"
}

Codes de statut

Code Signification Causes courantes
200 OK La requête a abouti. Le corps de la réponse contient les données demandées.
201 Créé Ressource créée avec succès. Renvoyé par les endpoints POST en cas de succès.
400 Requête incorrecte Champs manquants ou invalides dans le corps de la requête. Vérifiez que tous les champs obligatoires sont présents et correctement formatés.
401 Non autorisé Jeton d'authentification manquant ou invalide. Assurez-vous d'inclure un jeton Bearer valide dans l'en-tête Authorization. Le jeton a peut-être expiré — reconnectez-vous pour obtenir un nouveau jeton.
403 Interdit Vous êtes authentifié mais n'avez pas l'autorisation d'accéder à cette ressource. Cela signifie généralement que vous tentez d'accéder à une ressource appartenant à un autre restaurant ou de la modifier.
404 Introuvable La ressource demandée n'existe pas. Vérifiez que l'identifiant dans le chemin de l'URL est correct.
429 Trop de requêtes Limite de débit dépassée. Consultez l'en-tête Retry-After pour connaître le nombre de secondes à attendre avant de réessayer. Les endpoints d'authentification sont limités à 10 requêtes par tranche de 15 minutes par IP. La création de commandes est limitée à 5 requêtes par minute par IP.
500 Erreur interne du serveur Une erreur inattendue s'est produite sur le serveur. Si le problème persiste, contactez l'assistance. Ces erreurs sont journalisées automatiquement pour analyse.
503 Service indisponible Le service est temporairement indisponible. Cela peut se produire pendant une maintenance ou lorsqu'un service externe requis (par ex. le secret du worker) n'est pas configuré. Réessayez après un court délai.

Limitation du débit

Les endpoints soumis à une limite de débit renvoient un statut 429 lorsque la limite est dépassée. La réponse comprend :

  • L'en-tête Retry-After — Le nombre de secondes à attendre avant d'envoyer une nouvelle requête.
  • Un message d'erreur indiquant la limite de débit qui a été dépassée.

Les limites de débit s'appliquent par adresse IP. Limites actuelles :

Endpoint Limite
Connexion et inscription 10 requêtes par tranche de 15 minutes par IP
Création de commandes 5 requêtes par minute par IP
Articles associés 30 requêtes par minute par IP