Limites de débit et quotas de l'API Surfer

⏱ Limites de débit

Tous les points de terminaison appliquent une limite de débit par seconde ou par minute. Le dépassement renvoie 429 Too Many Requests.

Lorsque vous recevez une erreur 429, attendez avant de réessayer. Consultez l'en-tête Retry-After de la réponse pour savoir combien de temps attendre, puis réessayez. Utilisez un backoff exponentiel pour les flux de travail automatisés.

Surveiller les limites de débit via les en-têtes de réponse

Chaque réponse de l'API V2 inclut ces en-têtes pour que vous puissiez suivre les limites avant de les atteindre :

Lire x-ratelimit-remaining dans votre intégration vous permet de ralentir de manière proactive, au lieu d'attendre un 429.

📊 Quotas d'utilisation

Les quotas sont distincts des limites de débit : ils suivent le nombre de requêtes que vous avez consommées au cours d'une période de facturation. Les limites ci-dessous sont conformes à notre Politique d'utilisation équitable, pour l'offre Peace of Mind. Les limites Enterprise étant personnalisées, contactez votre Customer Success Manager pour vérifier votre quota, ou consultez votre tableau de bord Utilisation dans les Paramètres.

Remarque : il n'existe actuellement aucun point de terminaison API pour vérifier les crédits restants ou l'utilisation du quota par programmation. Pour éviter d'atteindre les limites en cours d'exécution, suivez votre propre utilisation ou consultez votre tableau de bord avant les tâches de traitement par lots importantes.

Ressources supplémentaires :

Introduction à l'API Surfer

Documentation de l'API Surfer (v1)

Documentation de l'API Surfer (v2)

Exemples d'utilisation de l'API Surfer