Skip to main content

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

Besoin de limites plus elevees ? Les clients Entreprise peuvent demander des limites de débit personnalisées. Contactez [email protected] pour plus de détails.

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éponse 429 Too Many Requests :
L’en-tête 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

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.
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.
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).
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.
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.
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

  1. Optimisez votre code pour réduire les requêtes inutiles
  2. Implémentez la mise en cache pour les données frequemment accedees
  3. Utilisez les webhooks pour remplacer les modèles de polling
  4. Regroupez les opérations quand c’est possible
  5. Envisagez de mettre à niveau votre plan
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.
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.
Important : Les limites de débit sont par clé API. Utiliser la même clé dans plusieurs services partagera la limite de débit.

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