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

# Limiti di frequenza

> Comprendi i limiti delle richieste e come gestire la logica dei nuovi tentativi con gli header di risposta.

## Limiti delle richieste

<Info>
  Il server MCP Octoparse consente fino a **300 richieste al minuto** per sessione OAuth. Questo limite si applica a tutte le chiamate agli strumenti MCP, incluse ricerca, esecuzione, esportazione e gestione delle attività.
</Info>

### Cosa accade quando viene superato il limite

<Warning>
  Se viene superato il limite delle richieste, il server restituisce HTTP `429 Too Many Requests`.
</Warning>

Usa gli header di risposta riportati di seguito per decidere quando riprovare, invece di affidarti a tempi di attesa fissi.

### Header per i nuovi tentativi

<table>
  <thead>
    <tr>
      <th style={{ width: "260px" }}>Header</th>
      <th>Descrizione</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Limit</code></td>
      <td>Numero massimo di richieste consentite nella finestra corrente del limite di frequenza.</td>
    </tr>

    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Remaining</code></td>
      <td>Numero di richieste rimanenti nella finestra corrente.</td>
    </tr>

    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Reset</code></td>
      <td>Timestamp ISO 8601 che indica quando viene reimpostata la finestra corrente. Usa questo valore per determinare il prossimo momento sicuro in cui riprovare.</td>
    </tr>

    <tr>
      <td><code style={{ whiteSpace: "nowrap" }}>X-RateLimit-Window</code></td>
      <td>Durata della finestra corrente del limite di frequenza in millisecondi.</td>
    </tr>
  </tbody>
</table>

### Gestione consigliata

<Steps>
  <Step title="Controlla il codice di stato">
    Se il server restituisce `429`, considera la richiesta soggetta al limite di frequenza anziché definitivamente non riuscita.
  </Step>

  <Step title="Leggi gli header per i nuovi tentativi">
    Controlla `X-RateLimit-Remaining` e `X-RateLimit-Reset` per capire se la finestra corrente è esaurita e quando verrà reimpostata.
  </Step>

  <Step title="Riprova dopo la reimpostazione">
    Attendi fino al momento indicato da `X-RateLimit-Reset` prima di inviare la richiesta successiva.
  </Step>
</Steps>