Quotas & limites
La passerelle protège les sites Brave : chaque clé partenaire a un quota par seconde et un quota par jour. Les dépasser renvoie 429 avec un en-tête Retry-After.
Les deux quotas
- Name
Quota par seconde- Type
- integer
- Description
Rythme soutenu autorisé (ex. 10 appels/s). Dépassé →
429immédiat.
- Name
Quota par jour- Type
- integer
- Description
Volume quotidien total (ex. 20 000 appels/j), remis à zéro à minuit (heure de la compagnie). Dépassé →
429jusqu'au lendemain.
Vos quotas exacts sont fixés avec votre contact Brave Booking et rappelés dans la réponse du ping.
Réponse 429
{
"error": {
"code": "rate_limited",
"message": "Quota dépassé. Réessayez plus tard."
}
}
En-têtes de la réponse :
| En-tête | Valeur |
|---|---|
Retry-After | Délai à attendre en secondes avant de réessayer |
X-RateLimit-Limit-Second / X-RateLimit-Remaining-Second | Quota et restant à la seconde |
X-RateLimit-Limit-Day / X-RateLimit-Remaining-Day | Quota et restant du jour |
Suivre son quota
GET /v1/{code}/ping renvoie l'état de vos quotas en temps réel :
{
"status": "ok",
"quota": {
"perSecond": 10,
"perDay": 20000,
"remainingToday": 19982,
"resetAt": "2026-11-14T00:00:00+01:00"
}
}
Détail : Ping.
Robots et crawlers
Les robots déclarés sont refusés : tout User-Agent se présentant comme un robot d'indexation est rejeté (403). Les appels d'API doivent porter un User-Agent identifiant votre application, par exemple MaAgence-B2B/1.2.
Bonnes pratiques
- Respectez
Retry-Afterplutôt que de réessayer en boucle ; ajoutez un backoff exponentiel (1 s, 2 s, 4 s…). - Cachez les lectures : catalogue et référentiels changent peu (les recherches identiques sont déjà cachées 5 minutes côté passerelle).
- Évitez les rafales en fin de journée : répartissez vos synchronisations sur la plage de reset.
- La recherche est la ressource la plus coûteuse : une recherche par ville peut interroger plusieurs hôtels — n'en lancez pas plus que nécessaire.