API
Limites de débit
Comprendre les limites de requêtes appliquées par l'API de Swaloo.
Limites de débit
Swaloo applique des limites de débit (fenêtre glissante) sur l'API externe et sur les endpoints publics, afin de protéger la plateforme contre les abus.
API externe
| Limiteur | Limite | Portée |
|---|---|---|
external_api | 100 requêtes / minute | par organisation |
La création d'expédition via POST /api/v1/external/shipments est comptée sur cette limite, par organisation (identifiée par la clé API). Voir API externe.
Endpoints publics
Les routes publiques (formulaire public, suivi, OTP, contact, etc.) ont leurs propres limites. Les principales :
| Limiteur | Limite | Portée |
|---|---|---|
public_request | 10 / minute | demande publique |
public_request_ip | 5 / heure | par IP |
public_tracking | 30 / minute | suivi public |
public_pricing | 300 / minute | estimation de prix |
public_detect_country | 60 / minute | détection de pays |
public_ticket | 5 / minute | création de ticket public |
public_contact | 3 / heure | formulaire de contact |
public_otp_ip | 10 / heure | OTP par IP |
public_otp_phone | 3 / 10 minutes | OTP par téléphone |
registration | 5 / heure | inscription |
verification_resend | 3 / heure | renvoi de vérification |
Dépassement
En cas de dépassement, l'API répond avec un code 429 Too Many Requests. Pour l'API externe, le message indique la limite atteinte (100 requêtes par minute).
Bonnes pratiques
- Implémentez un backoff exponentiel en cas de
429. - Privilégiez les webhooks au polling pour suivre les changements de statut.
- Regroupez les créations de colis lorsque c'est possible.
Voir aussi : API externe | Endpoints | Erreurs