Rate limiting

Il rate limiting ti consente di controllare il numero massimo di webhook consegnati al tuo endpoint al secondo. Questo protegge i tuoi sistemi dall’essere sopraffatti durante periodi di traffico elevato.

​

Come funziona

Quando imposti un rate limit su un endpoint:

1. I webhook vengono messi in coda per la consegna
2. La consegna viene limitata per rimanere entro il tuo limite
3. I webhook in eccesso vengono trattenuti e consegnati quando si libera capacità

Questo attenua i picchi di traffico, garantendo che il tuo endpoint riceva i webhook a un ritmo gestibile.

​

Impostare un rate limit

Puoi configurare il rate limiting quando crei o modifichi un endpoint:

1. Vai alle impostazioni Webhook nella tua dashboard
2. Clicca su un endpoint o creane uno nuovo
3. Nelle impostazioni Advanced, imposta il tuo Rate Limit
4. Inserisci il numero massimo di messaggi al secondo
5. Salva le modifiche

​

Scegliere un rate limit

Considera questi fattori quando imposti il tuo limite:

​

Esempi di limiti

• Server piccolo / Elaborazione semplice: 10-50 al secondo
• Infrastruttura media: 100-500 al secondo
• Sistemi ad alta capacità: 1.000+ al secondo

​

Considerazioni importanti

​

Accumulo in coda

Se ricevi costantemente più webhook di quanti il tuo rate limit consenta, si formerà un arretrato. Ad esempio:

• Rate limit: 100/secondo
• Tasso in arrivo: 200/secondo
• Risultato: la coda cresce, aumentando i ritardi di consegna

​

Tentativi e rate limit

I rate limit si applicano a tutte le consegne, compresi i tentativi. Un rate limit basso combinato con molti tentativi potrebbe ritardare i nuovi webhook.

​

Quando usare il rate limiting

Il rate limiting è utile quando:

• Il tuo endpoint ha capacità limitata — Prevenire il sovraccarico nei periodi di punta
• L’elaborazione richiede molte risorse — Ogni webhook attiva operazioni pesanti
• Dipendenze da terze parti — Il tuo handler chiama API esterne con rate limit
• Infrastruttura condivisa — L’elaborazione dei webhook compete con altri servizi