Límites de tasa - wondeya

Cada solicitud a /v1 tiene límite de tasa por clave de API, no por IP, así que el presupuesto de una clave es de la clave, sin importar cuántos hosts o funciones llamen detrás de ella.

Encabezados en cada respuesta

El presupuesto se anuncia en dos familias, una junto a la otra: los encabezados X-RateLimit-*, ampliamente adoptados, y los encabezados RateLimit del borrador del IETF.

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 47
RateLimit-Policy: 120;w=60
RateLimit: limit=120, remaining=118, reset=47

Reset son los segundos hasta que la ventana se recarga.

Por encima del límite

Superar el presupuesto responde 429 wondeya.rate_limit.exceeded con un Retry-After (en segundos):

HTTP/1.1 429 Too Many Requests
Retry-After: 47

Espera hasta que transcurra Retry-After. Un cliente que se comporta bien vigila X-RateLimit-Remaining y baja el ritmo antes de llegar a cero. Un 429 del endpoint de chat puede ser, en cambio, wondeya.usage.budget_exceeded: el tope diario de actividad del espacio de trabajo, no el límite por clave; no lleva Retry-After.