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, 413 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. Aquí no se publican
umbrales numéricos, porque ninguno está en vigor.
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
Las cargas muy grandes pueden rechazarse con 413 Payload Too Large. Cuando
este límite esté en vigor, una solicitud cuyo cuerpo supere el tamaño
admitido devolverá un cuerpo problem+json y no se
procesará. A diferencia de un 429, un 413 no tendrá éxito al reintentar:
debe enviar un archivo más pequeño.
Para estrategias de carga y descarga en streaming, tiempos de espera y procesamiento de documentos grandes, consulte Trabajar con archivos grandes.
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.