Límites y tamaños

Para que la plataforma permanezca estable, el API tiene restricciones sobre la frecuencia de solicitudes y el tamaño de los datos transmitidos.

Frecuencia de solicitudes

Si se supera la frecuencia permitida de solicitudes, el servidor responde con el código 429 Too Many Requests. La respuesta correcta es reintentar con retroceso exponencial (backoff): aumenta la pausa entre reintentos y no envíes solicitudes en ráfagas densas. Distribuye las operaciones masivas en el tiempo y reutiliza un solo token de forma secuencial, no en ráfagas paralelas.

Tamaño del cuerpo de solicitud

Para las solicitudes REST habituales, el tamaño del cuerpo JSON está limitado a 2 MiB. Es suficiente para cualquier configuración de reacciones, colecciones y ajustes. Si el cuerpo es más grande — divide la operación en partes (por ejemplo, importa las reacciones en lotes).

Tamaño del cuerpo al importar

Los endpoints de importación están diseñados para bundles grandes y tienen límites propios, más altos: hasta 64 MiB para importar datos y hasta 256 MiB para importar con medios incluidos. Si el bundle es más grande — divídelo en varias importaciones.

Superar los límites

  • Se superó el límite de frecuencia — 429, reintento con espera.
  • El cuerpo supera lo permitido — la solicitud se rechaza (413 o 400 según el endpoint); reduce o divide la carga útil.

Qué sigue