# 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.

<Warning>
  **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.
</Warning>

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](https://dashboard.pdfblocks.com). 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](/docs/api/errors). 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 cada `429` sucesivo (por ejemplo, duplicándola) en
  lugar de reintentar de inmediato en un bucle cerrado.
- **Respete `Retry-After`.** Cuando la respuesta traiga una cabecera
  `Retry-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](/docs/api/errors) 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](/docs/api/working-with-large-files).

## 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](https://dashboard.pdfblocks.com).
- **`403 Forbidden`**: su clave es válida pero no tiene permiso para usar el
  recurso solicitado.

Ambos aparecen en el catálogo de [Errores](/docs/api/errors) junto con la
forma completa de la respuesta.