Pour garantir une utilisation équitable et des performances optimales de l'API, certaines limitations sont appliquées. Dépasser ces limites peut entraîner une suspension temporaire de l'accès, il est donc important de comprendre et de surveiller attentivement votre utilisation.
Limites de requêtes
- Le nombre maximal de requêtes autorisées est de 10 000 par heure et par clé API.
- Si vous dépassez cette limite, votre clé API peut être suspendue temporairement jusqu'à 24 heures. Il s'agit d'une mesure de protection pour garantir que l'API reste stable et disponible pour tous les utilisateurs.
Pour éviter d'atteindre cette limite, envisagez de mettre en œuvre les bonnes pratiques suivantes :
- Surveillez votre utilisation des requêtes - Suivez le nombre de requêtes effectuées pour rester dans le seuil autorisé.
- Optimisez vos requêtes - Combinez la récupération des données lorsque cela est possible pour réduire le nombre de requêtes. Utilisez le traitement par lots lorsque l'API le supporte.
- Mettez en place une limitation de débit - Intégrez un délai ou un mécanisme de mise en file d'attente dans votre application pour éviter de surcharger l'API avec des requêtes trop rapides.
- Gérez gracieusement les erreurs de limitation de débit - Si votre limite de requêtes est dépassée, l'API renverra un code d'erreur approprié (par exemple, HTTP 429 - Trop de requêtes). Assurez-vous que votre application peut gérer ces erreurs et mettre en pause ou réessayer les requêtes après la période de suspension.
Requêtes sécurisées via HTTPS
Toutes les requêtes API doivent être effectuées via HTTPS pour garantir la sécurité et l'intégrité des données. Toute requête effectuée via HTTP simple échouera automatiquement. HTTPS chiffre la communication entre votre application et le serveur API, protégeant les informations sensibles telles que votre clé API et toutes les données transmises.
L'authentification est obligatoire
- Les requêtes API sans authentification échoueront.
- Vous devez inclure votre clé API ou jeton d'accès dans les en-têtes de requête, comme spécifié dans la documentation de l'API.
- Une authentification appropriée garantit que vos requêtes sont autorisées et peuvent être suivies pour la surveillance de l'utilisation et la limitation du débit.
Points clés
- Respectez la limite de 10 000 requêtes par heure pour éviter une suspension de 24 heures.
- Utilisez HTTPS pour toutes les requêtes ; HTTP n'est pas pris en charge et échouera.
- Assurez-vous que chaque requête est correctement authentifiée avec vos identifiants API uniques.
En respectant ces directives et en mettant en œuvre les meilleures pratiques, vous pouvez maintenir un accès fluide à l'API, éviter les interruptions et garantir une utilisation sécurisée et efficace.