Limiti e dimensioni

Per mantenere stabile la piattaforma, l'API ha limitazioni sulla frequenza delle richieste e sulla dimensione dei dati trasmessi.

Frequenza delle richieste

Quando si supera la frequenza consentita, il server risponde con il codice 429 Too Many Requests. La reazione corretta è il retry con backoff esponenziale: aumenta la pausa tra i tentativi e non inviare richieste in modo continuo. Distribuisci le operazioni massive nel tempo e riutilizza un unico token in sequenza, non con picchi paralleli.

Dimensione del corpo della richiesta

Per le normali richieste REST, il corpo JSON è limitato a 2 MiB. Questo è sufficiente per qualsiasi configurazione di reazioni, raccolte e impostazioni. Se il corpo è più grande, dividi l'operazione in parti (ad esempio, importa le reazioni in batch).

Dimensione del corpo in caso di import

Gli endpoint di import sono progettati per bundle di grandi dimensioni e hanno limiti separati, più alti: fino a 64 MiB per l'import di dati e fino a 256 MiB per l'import con media incorporati. Se il bundle è più grande, dividilo in più import.

Superamento dei limiti

  • Superato il limite di frequenza — 429, retry con delay.
  • Corpo più grande del consentito — la richiesta viene rifiutata (413 o 400 a seconda dell'endpoint); riduci o dividi il payload.

Passo successivo