Saltearse al contenido

Errores y 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.

PlanPeticiones por minuto
Starter10
Pro60
Business300

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-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset (timestamp Unix, segundos)
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1710000060
Retry-After: 42
{
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded for this subscription."
}

Haz backoff usando Retry-After (segundos) cuando esté presente.

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.

HTTPcodeCuándo
400validation / bad requestQuery o path inválidos
401UNAUTHORIZEDX-API-Key ausente o inválida
402BILLING_REQUIREDEl estado de billing bloquea el acceso
403INSUFFICIENT_CAPABILITYEl endpoint exige un nivel de capability superior
429RATE_LIMIT_EXCEEDEDSe 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.