Limites de debit

L’API Wappfy applique des limites de debit pour garantir une utilisation equitable et la stabilite de la plateforme.

Limites par defaut

Portee	Limite	Fenetre
Par utilisateur	100 requetes	1 minute
Par IP (non authentifie)	20 requetes	1 minute

Chaque reponse inclut des informations sur les limites de debit :

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1707580800

En-tete	Description
`X-RateLimit-Limit`	Nombre maximum de requetes autorisees dans la fenetre
`X-RateLimit-Remaining`	Requetes restantes dans la fenetre en cours
`X-RateLimit-Reset`	Horodatage Unix de la reinitialisation de la fenetre

Lorsque vous depassez la limite, vous recevrez une reponse 429 :

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}

Implementez un backoff exponentiel

Lorsque vous recevez un 429, attendez et reessayez avec des delais croissants : 1s, 2s, 4s, 8s…

Utilisez l'en-tete Reset

Consultez X-RateLimit-Reset pour savoir exactement quand vous pouvez reprendre.

Regroupez les operations lorsque c'est possible

Envoyez les messages avec des delais raisonnables entre eux plutot que de les envoyer en rafale.

Mettez en cache les reponses

Evitez de recuperer a nouveau des donnees qui n’ont pas change (par ex., details d’instance, infos de contact).