Límites de tasa & créditos
Qué se limita
Tu plan limita cuatro cosas, todas visibles en GET /v1/account: objetivos monitorizados, palabras clave, conexiones WebSocket concurrentes y solicitudes por minuto. Las dos primeras devuelven 402 plan_limit con details.resource, la tercera cierra el socket con 4002, la cuarta devuelve 429 rate_limited con una cabecera Retry-After.
Cabecera
Cada respuesta autenticada te dice dónde estás, para que un cliente pueda frenar antes de que se le rechace:
| Cabecera | Significado |
|---|---|
X-RateLimit-Limit | Solicitudes permitidas por minuto para esta clave |
X-RateLimit-Remaining | Lo que queda en el minuto actual |
X-RateLimit-Reset | Hora Unix en la que se reinicia la ventana |
X-Credits-Used-Today | Créditos consumidos por lecturas bajo demanda desde las 00:00 UTC |
X-Request-Id | Cítalo y podremos encontrar la solicitud exacta en nuestros registros |
X-Response-Time | Cuánto tardamos, en milisegundos |
ETag | Validador débil de una respuesta JSON; devuélvelo como If-None-Match |
Idempotent-Replay | true cuando la respuesta es una repetición de una solicitud anterior con la misma Idempotency-Key |
Retry-After | Segundos que hay que esperar, en cada 429 |
Location | Dónde vive el recurso creado o encolado, en 201 y 202 |
Créditos
El flujo no se contabiliza — una conexión inactiva y una ocupada cuestan lo mismo, y las tramas del socket no cuentan contra el presupuesto de solicitudes. Las lecturas REST bajo demanda de Lecturas consumen créditos, uno o dos por llamada según se indica en cada endpoint; GET /v1/account/usage muestra tus totales diarios.