Limites de débit & crédits
Ce qui est plafonné
Votre offre plafonne quatre choses, toutes visibles dans GET /v1/account : les cibles surveillées, les mots-clés, les connexions WebSocket simultanées et les requêtes par minute. Les deux premières renvoient 402 plan_limit avec details.resource, la troisième ferme le socket avec 4002, la quatrième renvoie 429 rate_limited avec un en-tête Retry-After.
En-tête
Chaque réponse authentifiée vous dit où vous en êtes, afin qu'un client puisse ralentir avant d'être refusé :
| En-tête | Signification |
|---|---|
X-RateLimit-Limit | Requêtes autorisées par minute pour cette clé |
X-RateLimit-Remaining | Ce qu'il reste dans la minute en cours |
X-RateLimit-Reset | Heure Unix à laquelle la fenêtre est réinitialisée |
X-Credits-Used-Today | Crédits consommés par les lectures à la demande depuis 00:00 UTC |
X-Request-Id | Citez-le et nous retrouverons la requête exacte dans nos journaux |
X-Response-Time | Le temps que nous avons mis, en millisecondes |
ETag | Validateur faible d'une réponse JSON ; à renvoyer en If-None-Match |
Idempotent-Replay | true quand la réponse est le rejeu d'une requête antérieure portant la même Idempotency-Key |
Retry-After | Secondes à attendre, sur chaque 429 |
Location | Où se trouve la ressource créée ou mise en file d'attente, sur 201 et 202 |
Crédits
Le flux n'est pas comptabilisé — une connexion inactive et une connexion chargée coûtent la même chose, et les trames sur le socket ne sont pas décomptées du budget de requêtes. Les lectures REST à la demande sous Lectures consomment des crédits, un ou deux par appel comme indiqué pour chaque point de terminaison ; GET /v1/account/usage affiche vos totaux quotidiens.