Les requêtes utilisent une seule fenêtre glissante de 60 secondes par compte, partagée par toutes les clés. Les dépenses réussies conservées à vie déterminent le palier du compte ; les protections par IP et par action peuvent refuser plus tôt ou séparément. Il n’existe aucun quota horaire ni par clé.
20 000 requêtes / minute / adresse IPAppliqué avant la validation de la clé afin de borner l'énumération par force brute des clés. Partagé entre toutes les clés derrière la même IP. La valeur par défaut est définie globalement et n'est pas configurable par l'utilisateur.
120–2 400 requêtes / 60 secondes glissantesToutes les clés API actives d’un compte consomment le même compteur. La grille fixe des dépenses réussies à vie fournit la limite, sauf dérogation RPM directe.
Dépend de l’actionCertaines actions sensibles ajoutent une règle de compte plus stricte. Par exemple, cancel accepte 30 requêtes par minute et par compte ; son 429 indique action.
La qualification utilise les dépenses réussies conservées sur toute la durée de vie du compte. Les livraisons complètes et partielles ajoutent le montant réussi conservé ; les remboursements ultérieurs le réduisent. La limite effective est mise à jour depuis le total stocké, sans tâche quotidienne. Utilisez action=account_status pour lire le palier acquis et les RPM effectives.
| Palier | Dépenses à vie minimales | Requêtes / minute |
|---|---|---|
| 0 | $0.00000000 | 120 |
| 1 | $10.00000000 | 300 |
| 2 | $50.00000000 | 600 |
| 3 | $100.00000000 | 900 |
| 4 | $500.00000000 | 1,200 |
| 5 | $1000.00000000 | 1,800 |
| 6 | $2500.00000000 | 2,400 |
| En-tête | Description |
|---|---|
| X-RateLimit-Limit | Sur les réponses normales, la limite effective de requêtes par minute partagée par le compte. Sur un 429, la limite signalée par la couche de refus. |
| X-RateLimit-Remaining | Sur les réponses normales, les requêtes restantes dans la fenêtre partagée du compte. Sur un 429, la valeur restante signalée par la couche de refus. |
| X-RateLimit-Reset | Nombre relatif de secondes avant la réinitialisation de la fenêtre signalée ; ce n’est pas un horodatage Unix. |
| X-RateLimit-Tier | Le palier acquis par les dépenses réussies à vie (0–6). Une dérogation RPM personnalisée ne modifie pas cette valeur. |
| X-RateLimit-Source | "tier" lorsque la grille fixe fournit les RPM effectives ; "custom" lorsqu’une dérogation directe de l’administrateur les fournit. |
| X-RateLimit-DeniedBy | Envoyé sur les réponses 429 lorsqu’un limiteur nommé refuse l’appel : "ip", "api_requests_per_minute" ou "action". |
| Retry-After | Pour une réponse 429 ou 503 réessayable, attendez au moins le nombre de secondes indiqué par Retry-After avant de réessayer. Pour action=add, réutilisez la même clé d’idempotence après l’attente. |
ip, api_requests_per_minute et action identifient la couche de refus ; changer de clé ne contourne pas la limite partagée du compte, de l’IP ou de l’action.action=status.