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 |