Errores y rate limits
Rate limits
Sección titulada «Rate limits»Los límites aplican a nivel de suscripción (compartidos por todas las API keys de esa suscripción). No se multiplican por el número de keys.
| Plan | Peticiones por minuto |
|---|---|
| Starter | 10 |
| Pro | 60 |
| Business | 300 |
Un RPM personalizado en la suscripción puede sustituir el valor del plan cuando se configura para clientes Business.
No hay cuota mensual de peticiones: el uso se limita por RPM (y protección antiabuso habitual).
Las respuestas correctas incluyen:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset(timestamp Unix, segundos)
Respuesta 429
Sección titulada «Respuesta 429»HTTP/1.1 429 Too Many RequestsX-RateLimit-Limit: 10X-RateLimit-Remaining: 0X-RateLimit-Reset: 1710000060Retry-After: 42
{ "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded for this subscription."}Haz backoff usando Retry-After (segundos) cuando esté presente.
Billing y 402
Sección titulada «Billing y 402»Mientras la suscripción está past due, el acceso continúa durante un periodo de gracia de 7 días. Al terminar la gracia (o si el billing está bloqueado por otro motivo), las peticiones responden 402 BILLING_REQUIRED hasta que la suscripción vuelva a estar al día.
Códigos de error habituales
Sección titulada «Códigos de error habituales»| HTTP | code | Cuándo |
|---|---|---|
| 400 | validation / bad request | Query o path inválidos |
| 401 | UNAUTHORIZED | X-API-Key ausente o inválida |
| 402 | BILLING_REQUIRED | El estado de billing bloquea el acceso |
| 403 | INSUFFICIENT_CAPABILITY | El endpoint exige un nivel de capability superior |
| 429 | RATE_LIMIT_EXCEEDED | Se superó el RPM de la suscripción |
Los bodies de error siguen una forma JSON coherente con al menos code y message. Los schemas completos están en la referencia OpenAPI.