Limites de débit de l'API Facebook Graph : erreurs 4, 17, 32, 613 et 80001
L'API Graph de Facebook accorde à un token de Page ou d'utilisateur système 4 800 appels à l'API Pages par utilisateur engagé, sur 24 heures glissantes. Au-delà d'une limite, elle renvoie 4, Application request limit reached ; 17, User request limit reached ; 32, Page request limit reached ; 613, Calls to this api have exceeded the rate limit ; ou 80001, There have been too many calls to this Page account. Arrêtez les appels, puis reprenez progressivement.
easyCoexistence appelle chaque Page connectée avec son propre token et reçoit son activité de fil, ses mentions et ses messages via les webhooks de Meta, en les transmettant à votre endpoint si vous le souhaitez, si bien que rien n'a besoin d'interroger la Page.
Le code lorsque l'application dont le token est utilisé dans la requête a atteint sa limite de débit.
Le code lorsque l'utilisateur dont le token est utilisé dans la requête a atteint sa limite de débit.
Le code lorsque l'utilisateur ou l'application dont le token est utilisé dans une requête à l'API Pages a atteint sa limite de débit.
Le code d'une limite de débit personnalisée ; avec le sous-code 1996, Meta a relevé un comportement incohérent dans le volume de requêtes de l'application.
Le code Business Use Case pour les appels à une Page effectués avec un token d'accès de Page ou d'utilisateur système.
Appels à l'API Pages autorisés sur 24 heures glissantes avec un token de Page ou d'utilisateur système.
Que signifie chaque code de limite de débit ?
Chaque code désigne la limite atteinte, et le token de la requête détermine celle qui s'applique. Le guide sur la limitation de débit de Meta explique ce que signifie chaque code, et ses références d'erreurs donnent le message qui l'accompagne. Les voici côte à côte, avec le message tel que Meta l'écrit :
| Meta's message | What reached its limit | |
|---|---|---|
| 4 | Application request limit reached | The app whose token made the request |
| 17 | User request limit reached | The user whose token made the request |
| 32 | (#32) Page request limit reached | The user or app token used in a Pages API request |
| 613 | (#613) Calls to this api have exceeded the rate limit. | A custom limit set by the API being called |
| 80001 | (#80001) There have been too many calls to this Page account. Wait a bit and try again. | Calls made on that Page with a Page or system user token |
Quelle limite s'applique à une Page ?
Cela dépend du token. Meta indique que les limites de débit des Pages peuvent suivre la logique Platform ou la logique Business Use Case, selon le type de token utilisé. Les appels à l'API Pages effectués avec un token de Page ou d'utilisateur système suivent la limite Business Use Case pour les Pages, tandis que les appels effectués avec un token d'utilisateur ou d'application relèvent des limites Platform de l'utilisateur ou de l'application. Lorsque les deux pourraient s'appliquer à une requête, Meta applique la limite Business Use Case.
Quelle est la taille des limites ?
Meta publie des formules plutôt que des chiffres fixes, si bien que chaque allocation augmente avec l'usage :
- Applications : 200 appels par heure pour chaque utilisateur actif quotidien, comptés sur l'ensemble des appels de l'application et non par utilisateur.
- Pages, avec un token de Page ou d'utilisateur système : 4 800 appels sur 24 heures glissantes pour chaque utilisateur ayant interagi avec la Page dans les 24 heures.
- API Send de Messenger : 300 appels par seconde et par Page pour le texte, les liens, les réactions et les stickers, et 10 pour l'audio ou la vidéo.
- Les appels Messenger ont aussi leur propre type Business Use Case, signalé par l'erreur 80006.
Comment voir qu'une limite approche ?
Lisez les en-têtes d'usage. Les endpoints qui reçoivent assez de requêtes d'une application renvoient X-App-Usage, dont call_count, total_cputime et total_time sont des pourcentages des limites Platform de l'application. Les réponses limitées selon la logique Business Use Case renvoient plutôt X-Business-Use-Case-Usage, avec les mêmes pourcentages pour chaque objet métier, le type de limite, comme pages, et estimated_time_to_regain_access.
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}
X-Business-Use-Case-Usage: {
"{business-object-id}": [
{
"type": "pages",
"call_count": 100,
"total_cputime": 34,
"total_time": 41,
"estimated_time_to_regain_access": 12
}
]
}Combien de temps attendre ?
Jusqu'à ce que l'usage baisse, ce que les en-têtes indiquent. Pour une limite Business Use Case telle que 80001, estimated_time_to_regain_access donne le nombre de minutes avant que les appels ne soient plus ralentis. Pour les limites Platform, le call_count de l'application couvre une période glissante d'une heure : il baisse donc à mesure que les anciens appels sortent de la fenêtre. Les recommandations de Meta sont les mêmes dans les deux cas : arrêtez d'effectuer des appels dès qu'une limite est atteinte, car continuer à appeler fait augmenter call_count et le délai avant que les appels ne réussissent à nouveau.
Comment rester sous les limites ?
Faites moins d'appels, et plus légers, et répartissez-les dans le temps. Les bonnes pratiques de Meta consistent à répartir les requêtes de façon régulière pour éviter les pics de trafic, à utiliser des filtres pour limiter la taille des réponses et éviter les appels qui demandent des données qui se chevauchent, et, lorsque des utilisateurs sont ralentis, à vérifier que l'application n'en est pas la cause. Les webhooks aident aussi : Meta transmet l'activité du fil d'une Page et ses messages au moment où ils surviennent, si bien qu'une application n'a pas à dépenser des appels pour les chercher.
Erreurs courantes
- Relancer tout de suite. Meta prévient que continuer à appeler fait augmenter le nombre d'appels comptés et le délai avant que les appels ne réussissent à nouveau.
- Traiter tous les codes de la même façon. 4 concerne l'application, 17 un utilisateur et 80001 une Page, donc ralentir le mauvais appelant ne change rien.
- Lire X-App-Usage pour des appels effectués avec un token de Page. Ceux-ci comptent dans la limite Business Use Case et sont signalés dans X-Business-Use-Case-Usage.
- Interroger souvent une Page peu active. Son quota dépend des utilisateurs qui ont interagi avec elle, donc une Page peu engagée dispose de moins d'appels à dépenser.
Lorsque Meta ralentit un appel, l'outil renvoie à Claude, ChatGPT ou à votre propre code le code et le message de Meta, afin que votre IA puisse attendre avant de réessayer, et qu'une publication que Meta ralentit soit relancée seule au bout de 5 minutes, 30 minutes et 2 heures. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Que signifie Application request limit reached ?
C'est l'erreur 4 : l'application dont le token a effectué l'appel a atteint sa limite de débit. Arrêtez les appels, puis reprenez progressivement à mesure que son usage baisse.
Quelle est la différence entre l'erreur 32 et l'erreur 80001 ?
Le token. L'erreur 32 est la limite Platform d'un token d'utilisateur ou d'application qui appelle l'API Pages ; 80001 est la limite par Page appliquée aux appels effectués avec un token de Page ou d'utilisateur système.
Combien de temps dure une limite de débit Facebook ?
Meta ne fixe pas de durée. Pour 80001, l'en-tête X-Business-Use-Case-Usage indique le nombre de minutes avant que les appels ne soient plus ralentis ; l'usage d'une application se mesure sur une heure glissante.
Que signifie l'erreur 613 ?
Une limite de débit personnalisée, définie par l'API appelée. Avec le sous-code 1996, Meta a relevé un comportement incohérent dans le volume de requêtes de l'application, par exemple après un changement récent dans le nombre de requêtes envoyées.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le