El plan de la cuenta fija cuántas validaciones pueden ejecutarse en un ciclo mensual. 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, a diferencia de las de límites de tasa, que solo aparecen al rechazar.

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.