Limites de débit

Chaque clé d’API a une limite soutenue en requêtes par seconde dérivée de votre plan (Free 1 req/s → Max 60 req/s — voir Tarifs). Les limites sont appliquées avec un seau à jetons : les pics jusqu’à votre capacité par minute sont autorisés, puis les requêtes sont lissées au débit soutenu.

Lorsque vous êtes limité

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms vous indique le temps minimum à attendre avant de réessayer.
L’en-tête x-ratelimit-remaining sur chaque réponse indique combien de requêtes restent cette minute.

Concurrence

Au-delà du débit par seconde, il existe un plafond sur les requêtes en cours. Si vous lancez de nombreuses requêtes en même temps, vous pouvez voir :

409 request_in_progress — une requête idempotente identique est déjà en cours.
503 too_many_concurrent_requests — trop de requêtes concurrentes en cours ; temporisez et réessayez.

Gérer les limites

Respectez retry_after_ms ; sinon utilisez un backoff exponentiel avec jitter.
Maintenez un plafond de concurrence côté client adapté au débit de votre plan.
Les SDK officiels réessaient les 429/503 automatiquement.