API v1 / schéma 1.0.0
Erreurs et limites de l'API de taxe de séjour
Gérer les défaillances sans modifier les taxes.
Utilisation des erreurs {"error":{"code":"…","message":"…"}}. Lisez d'abord le statut HTTP. Ne remplacez jamais les paramètres enregistrés de taxe de séjour pour un hébergement après une requête infructueuse.
| Statut | Action |
|---|---|
| 400 | Corrigez les entrées de la requête. |
| 401 | Vérifiez qu'une clé active valide a été fournie. |
| 403 | Vérifiez les scopes de la clé et les pays autorisés. |
| 422 | Le périmètre dépasse la limite examinée. Inspectez une juridiction plus restreinte. |
| 429 | Respectez le délai de nouvelle tentative ; utilisez un backoff borné. |
| 503 | Les données ou le service sont indisponibles. Conservez les paramètres existants et réessayez plus tard. |
Les clés ont par défaut 300 requêtes par minute sauf si l'opérateur prévoit une limite différente. Le proxy anonyme du site web a des limites distinctes et plus strictes. Ne l'utilisez pas comme API d'intégration en production.
Définissez un délai limité, évitez d'enregistrer les clés ou adresses, et ne réessayez pas indéfiniment les échecs de validation ou d'authentification.