Limiti di frequenza
Engine ≥ 4.143.0. Ogni risposta del token include data.rate_limits dalla politica del negozio al momento dell’emissione. Tutte le chiavi condividono questi limiti; un nuovo token non li azzera. Un cambio di piano può applicarsi prima della scadenza del token.
- read_per_minute
- Richieste di lettura al minuto.
- write_per_minute
- Richieste di scrittura al minuto; questo valore non concede permessi di scrittura.
- auth_per_minute
- Richieste di token al minuto, inclusi i tentativi di autenticazione non riusciti.
Distribuisci uniformemente le richieste; con un limite di lettura positivo, attendi almeno 60 / read_per_minute secondi tra le letture. Il limite non garantisce altrettante richieste simultanee. Anche altre integrazioni lo condividono: gestisci 429 e Retry-After.
Zero significa non disponibile, non illimitato.
Limiti al minuto
| Disponibile dal piano | Lettura · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- Scrittura
- 10
- Autenticazione
- 10
Tutte le chiavi dello stesso negozio condividono questi limiti.
Richiesta
- Letture e scritture sono soggette alla politica API corrente del negozio.
- Le chiavi non forniscono capacità illimitata separata.
- Limita la concorrenza, memorizza temporaneamente i dati di riferimento quando opportuno ed evita letture ripetute di dettagli invariati.
429 · Retry-After
- Quando l’API restituisce 429 con rate_limit.exceeded, attendi almeno i secondi indicati da Retry-After e aggiungi un ritardo casuale prima di riprovare.
- 429 · capacity.queue_full — La breve coda dell’API è piena; l’esecuzione della richiesta non è iniziata. 429 · capacity.wait_timeout — Il tempo di attesa nella coda dell’API è scaduto; l’esecuzione della richiesta non è iniziata. Attendi almeno i secondi indicati da Retry-After e aggiungi un ritardo casuale. Per ripetere una scrittura conserva chiave e contenuto originali.
- Usa codice e header documentati invece di presumere un intervallo fisso.