- 1xx : Informationnel - Communique des informations au niveau du protocole de transfert.
- 2xx : Succès - La requête a abouti.
- 3xx : Redirection - Le client doit effectuer une action supplémentaire pour compléter la requête.
- 4xx : Erreur client - Requête échouée en raison d’une erreur du client.
- 5xx : Erreur serveur - Requête échouée en raison d’une erreur serveur.
200 Success
Une requête réussie a été effectuée.400 Bad Request
Une erreur400 Bad Request signifie que le serveur n’a pas pu traiter la requête. La cause la plus fréquente de cette erreur est une syntaxe incorrecte dans l’URL de la requête ou dans son corps.
401 Unauthorized
Les erreurs401 Unauthorized sont généralement dues à un problème dans l’en-tête de requête de votre appel API, c’est-à-dire que vous n’avez pas utilisé une API Key valide pour effectuer l’appel API.
403 Access Denied
Lorsque votre application effectue un appel API avec votre API Key et que la requête n’est pas autorisée. Une erreur 403 peut également être renvoyée si le User Profile est suspendu.404 Resource Not Found
Cette erreur survient lorsque votre application essaie d’appeler une API ou de récupérer une entité qui n’existe pas.405 Method Not Allowed
Cette erreur indique que les méthodes du protocole HTTP dans votre requête ne sont pas prises en charge. Consultez la documentation de l’API pour connaître les méthodes prises en charge.429 Rate Limit
Limites de débit du User Profile
Chaque User Profile a une limite de débit de 300 requêtes API par intervalle de 5 minutes. Vous pouvez surveiller votre utilisation de la limite de débit via les en-têtes de réponse :x-ratelimit-max: indique le nombre maximum de requêtes autorisées par période de 5 minutesx-ratelimit-count: affiche le nombre de requêtes que vous avez effectuées pendant la période actuelle de 5 minutes
Nous vous recommandons de vérifier la présence de réponses avec code d’erreur 429. Si vous voyez une erreur 429, vous avez atteint votre limite
de débit. Des tentatives répétées de dépassement de la limite de débit peuvent entraîner la suspension du User Profile.Apprenez-en davantage sur la gestion des limites de débit pour plusieurs user profiles.
Limites de débit des statistiques par plateforme
Le code HTTP429 peut également être renvoyé lorsqu’un réseau social limite les appels de statistiques pour un compte spécifique — indépendamment des limites de votre User Profile Ayrshare. Dans ce cas, la réponse contient un code d’erreur Ayrshare spécifique à la plateforme (par exemple code: 444 pour la limite de débit des statistiques par Page Facebook). Examinez le champ code pour distinguer une limite de débit de profil d’une limitation côté plateforme, et réessayez avec un backoff plutôt que de demander à l’utilisateur de reconnecter son compte.
Limites de débit de suppression de User Profile
Vous pouvez supprimer 8 user profiles par seconde. Veuillez espacer vos appels API si vous avez besoin de supprimer en masse.Politique de protection contre les limites de débit et de suspension
Pour protéger l’intégrité de notre système, nous appliquons une suspension automatique si un User Profile dépasse trop fréquemment les limites de débit. Voici comment cela fonctionne : Lorsque vous effectuez des requêtes API, vous devez gérer soigneusement la fenêtre de 5 minutes. Par exemple, si vous effectuez 300 requêtes en une minute, vous devrez attendre quatre minutes supplémentaires avant de pouvoir effectuer d’autres requêtes. Toute requête pendant cette période d’attente déclenchera une réponse d’erreur429.
Si un User Profile cumule 1 000 violations de la limite de débit (erreurs 429) sur une période de 24 heures, le profil sera automatiquement suspendu.
Après l’expiration d’une période d’attente de 5 minutes, vous pouvez reprendre vos requêtes dans la limite standard de 300 par fenêtre de 5 minutes.
500 Internal Server Error
Une erreur500 Internal Server Error indique qu’Ayrshare rencontre une erreur interne ou qu’un traitement a échoué.