Limites et tailles
Que faire si les requêtes sont trop fréquentes ou si un fichier est trop gros : codes 429 et 413, taille des corps et archives d’import.
Sur cette page
Si un programme appelle trop souvent l’API, le serveur peut demander d’attendre. Si le corps envoyé est trop gros, la requête est refusée. Voici comment gérer ces cas. Les limites du constructeur sont réunies dans Limites de la plateforme.
Fréquence des requêtes
429 Too Many Requests signifie que trop de requêtes ont été envoyées. Attendez avant de réessayer, puis augmentez le délai si l’erreur revient, par exemple 1, 2 puis 4 secondes. C’est le délai exponentiel (backoff). Étalez les opérations massives dans le temps au lieu de lancer de nombreuses requêtes ensemble.
Taille du corps
Pour une requête REST ordinaire, le corps JSON est limité à 2 Mio. S’il est plus gros, répartissez l’opération, par exemple en important les réactions en plusieurs lots.
Taille des archives d’import
L’import a ses propres limites : 64 Mio pour l’archive des réactions et fichiers associés, 256 Mio pour l’historique des conversations et ses pièces jointes. La taille du fichier téléversé et le total après décompression sont limités. Divisez les données en plusieurs imports si nécessaire.
Dépassement
- Trop de requêtes :
429, réessayez avec un délai. - Corps trop gros :
413ou400selon l’endpoint ; réduisez-le ou divisez-le.
Pour aller plus loin
- Erreurs :
429et autres codes. - Importer depuis sambot : grandes archives.
- Référence interactive : limites propres à chaque endpoint.