Limites de débit

Plusieurs compteurs protègent l’API. Une requête refusée répond 429 RATE_LIMITED avec l’en-tête Retry-After (secondes) ; le corps nomme le compteur (limit), sa fenêtre (windowSeconds) et le délai (retryAfter).

Compteur (`limit`)	Plafond	`windowSeconds`	Compté par	S’applique à
`PRE_AUTH`	30 requêtes / 1 min	60	adresse IP	les requêtes sans clé ou avec une clé inconnue
`PER_KEY`	120 requêtes / 1 min	60	clé API	toute requête d’une clé reconnue, erreurs comprises (même désactivée, révoquée ou expirée)
`WRITE`	30 requêtes / 5 min	300	clé API	`POST /rentals`, `POST /rentals/{rentalId}/photo-uploads`, `POST /rentals/{rentalId}/photos`
`WRITE`	60 requêtes / 1 min	60	clé API	toute autre écriture (`POST`, `PUT`, `PATCH`, `DELETE`)
`QUOTE`	120 requêtes / 1 min	60	clé API	`POST /quotes` et toute requête avec `?dryRun=true`

Les deux plafonds WRITE se distinguent par windowSeconds.
Les en-têtes RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset (secondes avant la remise à zéro) décrivent le compteur PER_KEY ; RateLimit-Policy donne son plafond et sa fenêtre en secondes, sous la forme plafond;w=fenêtre. Les autres compteurs ne se signalent que par le 429.
Le renvoi d’une requête avec la même Idempotency-Key ne consomme ni le compteur WRITE ni le compteur QUOTE, sauf pour la préparation et l’enregistrement de photos. Une écriture refusée (4xx ou 5xx) est rendue au compteur WRITE ; le compteur QUOTE compte aussi les refus.
?dryRun=true compte dans QUOTE, pas dans WRITE.
Les plafonds sont des maximums, pas des garanties de débit.
Sur 429, attendez Retry-After, puis renvoyez la même requête avec la même Idempotency-Key.

Introduction

Bien démarrer

Intégrer

Évolutions