Rate limits y uso
Cómo se contabilizan las solicitudes en su plan, cómo es la respuesta 429 y el límite de tamaño de una sola solicitud.
Con vistas al futuro. El rate limiting, los topes de uso y las
respuestas 402, 403 y 429 forman parte del contrato de la API
pero todavía no se aplican. Esta página describe cómo se comportan para
que pueda construir un cliente preparado para ellas. No se publican
umbrales numéricos para ellas, porque ninguno está en vigor. Los límites de
tamaño de la solicitud son la excepción: se aplican desde ya, y el límite
se publica más abajo.
PDF Blocks está construido para degradarse con elegancia bajo carga y para mantener su uso a la vista. Esta página cubre cómo se mide el uso, cómo se manifiesta el rate limiting y cómo dimensionar sus solicitudes.
Cómo se mide el uso
El uso se mide por plan y se registra en su dashboard. El dashboard es la fuente de verdad de lo que ha consumido de su plan, tanto el número de documentos procesados como el número de solicitudes realizadas. Consúltelo para vigilar el consumo y ver lo cerca que está del límite de su plan.
Como la API es stateless, cada solicitud se mide por separado; no hay sesiones ni lotes que conciliar. Una acción de varios documentos, como una división, sigue contando como una sola solicitud.
Rate limits y la respuesta 429
Cuando el rate limiting esté en vigor, las solicitudes que superen el límite
de su plan se responderán con 429 Too Many Requests y un cuerpo
problem+json. Un 429 es transitorio: la misma solicitud
tendrá éxito en cuanto reduzca el ritmo.
Construya sus clientes para manejarlo desde el primer día:
- Espere de forma exponencial. Ante un
429, espere antes de reintentar y aumente la demora en cada429sucesivo (por ejemplo, duplicándola) en lugar de reintentar de inmediato en un bucle cerrado. - Respete
Retry-After. Cuando la respuesta traiga una cabeceraRetry-After, espere al menos ese tiempo antes de reintentar en lugar de usar su propia demora. - Añada variación aleatoria. Aleatorice ligeramente la espera para que los procesos en paralelo no reintenten todos a la vez.
- Limite los reintentos. Ríndase después de un número razonable de intentos y muestre el fallo en lugar de reintentar para siempre.
La misma estrategia de espera se aplica al poco frecuente error de servidor
5xx.
Límites de tamaño de la solicitud
Cada plan limita el tamaño de un único documento de entrada: 5 MB en Free, 10
MB en cualquier otro plan (consulte Precios). Una solicitud cuyo
cuerpo supere ese límite se rechaza con 413 Payload Too Large y devuelve un
cuerpo problem+json sin procesarse. A diferencia de un
429, un 413 no tendrá éxito al reintentar: envíe un archivo más pequeño,
o pídanos que elevemos el límite de su cuenta si necesita más de forma
habitual.
Respuestas relacionadas con la facturación
Otros dos códigos reservados se refieren a su cuenta y no a la solicitud concreta:
402 Payment Required: una condición de facturación o de cuota en su plan. Resuélvala desde el dashboard.403 Forbidden: su clave es válida pero no tiene permiso para usar el recurso solicitado.
Ambos aparecen en el catálogo de Errores junto con la forma completa de la respuesta.