Chaque erreur utilise la même structure JSON, donc un seul gestionnaire suffit pour toutes.
{
"error": {
"code": "forbidden",
"message": "this API key is missing the \"write\" scope"
}
}
Codes d’état
| Status | code | When |
|---|---|---|
| 400 | validation_error | Le corps ou la requête a échoué à la validation. error.fields nomme chaque champ |
| 401 | unauthorized | La clé est manquante, invalide, révoquée ou désactivée |
| 402 | plan_limit | Votre offre ne comprend pas cette fonctionnalité, ou une limite de l’offre a été atteinte |
| 403 | forbidden | La clé n’a pas le scope requis par cet endpoint |
| 404 | not_found | La ressource n’existe pas dans cet espace de travail |
| 429 | rate_limited | Trop de requêtes provenant de cette clé |
| 500 | internal_error | Un problème est survenu de notre côté. Réessayez avec une stratégie de backoff |
Limites de débit
Chaque clé peut effectuer 120 requêtes toutes les 60 secondes, partagées entre l’API REST et le serveur MCP. Les réponses incluent les en-têtes standard RateLimit et RateLimit-Policy, afin que vous puissiez ralentir avant d’atteindre la limite.
Bonne pratique
- Réessayez les réponses
429et5xxavec une stratégie de backoff exponentiel. Ne réessayez pas les erreurs4xxautres que429. - Conservez les clés sur votre serveur. Ne les intégrez jamais dans un navigateur ou une application mobile.
- Utilisez une clé distincte par application, afin de pouvoir en faire la rotation ou la révoquer sans interrompre les autres.
Cela vous a-t-il été utile ?
Publiez des posts cohérents avec votre marque en quelques minutes
Retour à la documentationContenu IA, planification, engagement et une suite marketing complète — gratuit pour commencer.
Commencer gratuitement
