Limites e tamanhos

Para que a plataforma permaneça estável, a API possui limites de frequência de requisições e de tamanho dos dados transmitidos.

Frequência de requisições

Quando a frequência permitida de requisições é excedida, o servidor responde com o código 429 Too Many Requests. A reação correta é tentar novamente com backoff exponencial: aumente o intervalo entre tentativas e não envie requisições em fluxo contínuo. Distribua operações em massa ao longo do tempo e reutilize um único token de forma sequencial, não com picos paralelos.

Tamanho do corpo da requisição

Para requisições REST comuns, o tamanho do corpo JSON é limitado a 2 MiB. Isso é suficiente para qualquer configuração de reações, coleções e configurações. Se o corpo for maior — divida a operação em partes (por exemplo, importe reações em lotes).

Tamanho do corpo na importação

Os endpoints de importação são projetados para bundles grandes e possuem limites separados e mais altos: até 64 MiB para importação de dados e até 256 MiB para importação com mídia embutida. Se o bundle for maior — divida em múltiplas importações.

Excedendo os limites

• Limite de frequência excedido — 429, tente novamente com atraso.
• Corpo maior que o permitido — a requisição é rejeitada (413 ou 400 dependendo do endpoint); reduza ou divida o payload.

Próximos passos

• Erros — sobre 429 e outros códigos.
• Importação do SamBot — sobre bundles de importação grandes.
• Referência interativa — limites de endpoints específicos.