Limiti di frequenza

L’API Wappfy applica limiti di frequenza per garantire un utilizzo equo e la stabilita della piattaforma.

Limiti predefiniti

Ambito	Limite	Finestra
Per utente	100 richieste	1 minuto
Per IP (non autenticato)	20 richieste	1 minuto

Ogni risposta include informazioni sui limiti di frequenza:

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

Header	Descrizione
`X-RateLimit-Limit`	Numero massimo di richieste consentite nella finestra
`X-RateLimit-Remaining`	Richieste rimanenti nella finestra corrente
`X-RateLimit-Reset`	Timestamp Unix di quando la finestra viene reimpostata

Quando superi il limite, riceverai una risposta 429:

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

Implementa il backoff esponenziale

Quando ricevi un 429, attendi e riprova con ritardi crescenti: 1s, 2s, 4s, 8s…

Usa l'header Reset

Controlla X-RateLimit-Reset per sapere esattamente quando puoi riprendere.

Raggruppa le operazioni dove possibile

Invia i messaggi con ritardi ragionevoli tra di loro invece di inviarli tutti insieme.

Memorizza le risposte nella cache

Evita di recuperare dati che non sono cambiati (es. dettagli dell’istanza, informazioni sui contatti).