> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limiting

> Controlla la velocità con cui storekit consegna i webhook al tuo endpoint. Imposta limiti al secondo per proteggere i tuoi sistemi da picchi durante i periodi di ordini più intensi.

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](https://dashboard.storekit.com/developers/webhooks) 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:

| Fattore               | Consiglio                                                                  |
| --------------------- | -------------------------------------------------------------------------- |
| Capacità del server   | Inizia con ciò che il tuo server può gestire comodamente                   |
| Tempo di elaborazione | Se ogni webhook richiede 100ms per essere elaborato, limita a \~10/secondo |
| Worker concorrenti    | Più worker = tasso sostenibile più elevato                                 |
| Traffico di picco     | Tieni conto dei periodi di punta (pausa pranzo, promozioni)                |

### 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

<Warning>
  Se il volume dei tuoi webhook supera costantemente il tuo rate limit, i webhook subiranno ritardi. Monitora il tuo endpoint e aumenta il limite se necessario.
</Warning>

### 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

<Tip>
  Inizia con un rate limit conservativo e aumentalo man mano che comprendi la capacità del tuo sistema. È più facile alzare un limite che riprendersi da un server sovraccarico.
</Tip>


## Related topics

- [Crea stories del menu con contenuti video e CTA](/docs/it/guides/marketing/stories.md)
- [Klarna](/docs/it/guides/payments/klarna.md)
- [Video](/docs/it/guides/menu-engineering/videos.md)
- [Modificatori](/docs/it/guides/menu/modifiers.md)
- [Banner promozionali](/docs/it/guides/marketing/promotional-banners.md)