Aller au contenu
Sections de la documentation

Limites de requêtes

Safecube limite le rythme des requêtes à l'API pour éviter que la plateforme reçoive plus de trafic qu'elle ne peut en traiter, et pour partager ses ressources équitablement entre les clients. Les limites peuvent évoluer.

Rythme des requêtes

La limite actuelle est de 10 requêtes par tranche de 10 secondes par clé d'API.

La limite se compte par clé d'API, pas par endpoint : toutes les requêtes envoyées avec la même clé puisent dans le même quota.

Dépasser la limite

Une requête envoyée au-delà de la limite n'est pas traitée. Elle reçoit le code de statut 429 Too Many Requests.

Une réponse 429 est temporaire : relancez la requête peu après, une fois la fenêtre de 10 secondes passée. Pour rester sous la limite, espacez les requêtes côté client plutôt que de les envoyer en rafales et de relancer celles qui échouent.

Crédits de la Congestion API

La Congestion API ajoute un quota de crédits à la limite de requêtes. Ses deux refus sont distincts :

  • Quota de crédits atteint : la requête reçoit 403 Forbidden, est bloquée avant tout traitement et ne consomme aucun crédit. Rechargez vos crédits ou attendez la période suivante.
  • Trop de requêtes sur une fenêtre courte : la requête reçoit 429 Too Many Requests, comme sur toutes les autres API Safecube.

Suivre beaucoup de conteneurs

Interroger la Container Tracking API pour chaque conteneur est le moyen le plus rapide d'atteindre la limite de requêtes. Pour de gros volumes, la Webhooks API inverse le flux : vous ajoutez une fois vos expéditions à votre liste de suivi, et Safecube envoie un event à votre endpoint dès que de nouvelles données de suivi sont disponibles, sans aucune requête de votre part. La page Suivi synchrone et asynchrone compare les deux approches.