Limites de débit et codes d'erreur de l'API

Pour garantir un service rapide et stable, le nombre de requêtes par clé API est limité par minute.

Limites selon le forfait

• Gratuit : API non incluse.
• Pro : 60 requêtes par minute.
• Business : 300 requêtes par minute.

Au-delà, l'API répond HTTP 429 jusqu'à la réinitialisation de la fenêtre. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset et Retry-After vous indiquent où vous en êtes.

Codes de statut

• 200 : succès.
• 400 : paramètres invalides, le message explique le problème.
• 401 : clé API manquante ou invalide.
• 403 : fonctionnalité non disponible dans votre forfait, ou compte inactif.
• 404 : ressource inexistante ou qui ne vous appartient pas.
• 409 : la ressource existe déjà (domaine, alias…).
• 429 : trop de requêtes.
• 500 : erreur serveur, réessayez plus tard.

Bonnes pratiques

Mettez en place une attente avant de réessayer en cas de 429, et mettez en cache les réponses que vous consultez souvent.