Aperçu
Pour garantir une utilisation equitable et maintenir des performances optimales, l’API Smartbills implemente une limitation de débit. Cela aide à contrôler le trafic des requêtes entrantes et offre une expérience API fluide et previsible pour tous les utilisateurs.Utilisation equitable : Les limites de débit garantissent qu’aucun utilisateur ne peut monopoliser les ressources de l’API, maintenant un service de qualité pour tous.
Limites de débit par plan
En-têtes de limite de débit
Chaque réponse API inclut des informations sur la limite de débit dans les en-têtes :integer
Nombre maximum de requêtes autorisées par minute pour votre plan
integer
Nombre de requêtes restantes dans la fenêtre actuelle
integer
Horodatage Unix (en secondes) du moment où la fenêtre de limite de débit se réinitialise
Réponse de limite de débit dépassée
Lorsque vous depassez la limite de débit, vous recevez une réponse429 Too Many Requests :
Retry-After indique combien de secondes attendre avant de réessayer.
Gérer les limites de débit
Vérifier les en-têtes de limite de débit
Surveillez toujours les en-têtes de limite de débit dans votre application :Implémenter un backoff exponentiel
Lorsque vous recevez une erreur 429, implémentez un backoff exponentiel :Bonnes pratiques
Utiliser la mise en cache
Utiliser la mise en cache
Mettez en cache les réponses API pour réduire les requêtes redondantes. Utilisez une invalidation de cache basée sur le temps pour les données qui ne changent pas frequemment.
Utiliser la pagination efficacement
Utiliser la pagination efficacement
Utilisez la taille de page maximale (100) pour le traitement en lot afin de minimiser le nombre d’appels API. Consultez Pagination pour plus de détails.
Regrouper les requêtes
Regrouper les requêtes
Combinez plusieurs opérations en requêtes uniques lorsque des points d’accès en lot sont disponibles (ex. : mise à jour en lot des dépenses).
Utiliser les webhooks au lieu du polling
Utiliser les webhooks au lieu du polling
Utilisez les webhooks pour recevoir des notifications en temps réel au lieu d’interroger l’API pour les changements. Consultez Webhooks pour les instructions de configuration.
Implémenter une file d'attente de requêtes
Implémenter une file d'attente de requêtes
Mettez les requêtes en file d’attente et traitez-les à un débit contrôle pour eviter les rafales qui depassent votre limite de débit.
Surveiller l'utilisation
Surveiller l'utilisation
Suivez vos habitudes d’utilisation de l’API et configurez des alertes lorsque vous approchez des limites de débit.
Demander des limites plus elevees
Les clients Entreprise peuvent demander des limites de débit personnalisées :- Courriel : [email protected]
- Incluez votre cas d’utilisation, le volume de requêtes prévu et les détails de votre plan actuel
- Délai d’approbation typique : 2-3 jours ouvrables
Dépannage
Atteindre régulièrement les limites de débit
Atteindre régulièrement les limites de débit
- Optimisez votre code pour réduire les requêtes inutiles
- Implémentez la mise en cache pour les données frequemment accedees
- Utilisez les webhooks pour remplacer les modèles de polling
- Regroupez les opérations quand c’est possible
- Envisagez de mettre à niveau votre plan
En-têtes de limite de débit manquants
En-têtes de limite de débit manquants
Assurez-vous d’utiliser la dernière version de l’API (v1) et vérifiez que votre client HTTP ne supprime pas les en-têtes de réponse.
Erreurs 429 inattendues
Erreurs 429 inattendues
Vérifiez s’il y a plusieurs instances de votre application en cours d’exécution, des clés API partagées entre les services, ou des scripts automatises utilisant la même clé. Utilisez des clés API séparées pour chaque environnement et service.
Ressources connexes
Webhooks
Utiliser les webhooks au lieu du polling
Gestion des erreurs
Gérer les erreurs de limite de débit
Pagination
Paginer efficacement les résultats
Clés API
Gérer vos clés API