Limites et tailles

Pour que la plateforme reste stable, l'API impose des limites sur la fréquence des requêtes et la taille des données transmises.

Fréquence des requêtes

En cas de dépassement de la fréquence autorisée, le serveur répond avec le code 429 Too Many Requests. La bonne réaction est un retry avec délai exponentiel (backoff) : augmentez la pause entre les tentatives et n'envoyez pas de requêtes en rafale. Répartissez les opérations en masse dans le temps et réutilisez un seul jeton de façon séquentielle, plutôt qu'en pics parallèles.

Taille du corps de requête

Pour les requêtes REST ordinaires, la taille du corps JSON est limitée à 2 Mio. Cela est suffisant pour toutes les configurations de réactions, collections et paramètres. Si le corps est plus volumineux — découpez l'opération en parties (par exemple, importez les réactions par lots).

Taille du corps lors d'un import

Les endpoints d'import sont conçus pour de grands bundles et disposent de limites séparées, plus élevées : jusqu'à 64 Mio pour l'import de données et jusqu'à 256 Mio pour l'import avec médias intégrés. Si le bundle est plus grand — divisez-le en plusieurs imports.

Dépassement des limites

  • Limite de fréquence dépassée — 429, retry avec délai.
  • Corps plus grand que la limite — la requête est rejetée (413 ou 400 selon l'endpoint) ; réduisez ou découpez la charge utile.

Pour aller plus loin