Cuotas y planes

El plan de la cuenta fija cuántas validaciones pueden ejecutarse en un ciclo mensual. En un plan anual el ciclo de cuota sigue siendo mensual: el año se parte en meses a partir de la fecha de inicio de la suscripción, y cada mes empieza con la cuota completa. La cuota se consume al admitir la operación, antes de procesarla, de modo que el consumo refleja las operaciones aceptadas y no las que fueron rechazadas por validación.

Un reintento automático no consume cuota adicional: pertenece a la validación que ya la consumió.

Cabeceras de consumo

Las operaciones sujetas a cuota informan del estado en cada respuesta, sin necesidad de una consulta aparte:

Estas cabeceras acompañan tanto a las respuestas correctas como a la de cuota agotada. Las X-RateLimit-* de los límites de tasa miden otra cosa, peticiones por minuto y no validaciones por ciclo, y además de salir en cada 429 acompañan las respuestas correctas de la API con API key.

Cuota agotada

Alcanzado el tope, las operaciones sujetas a cuota responden 429 con rate_limit_exceeded y una cabecera Retry-After que indica los segundos que faltan para el próximo ciclo.

La distinción con un límite de tasa está en la escala: un 429 por límite de tasa se resuelve esperando segundos; uno por cuota agotada se resuelve cambiando de plan o esperando al ciclo siguiente. El valor de Retry-After los diferencia sin ambigüedad.

La cuenta recibe un aviso al alcanzar el 80 % del consumo y otro al agotarlo, una sola vez por ciclo.

Consulta del consumo

El histórico refleja el tope del plan actual en cada período: los cambios de plan pasados no se conservan, de modo que un mes anterior se muestra contra el límite vigente hoy.