# Limiti delle richieste e della concorrenza

Limiti delle richieste, limiti delle attività e gestione di 429.

Fonte: https://scifig.ai/it/docs/api/rate-limits

## Limiti

| Limite | Valore | Si applica a |
| --- | --- | --- |
| Richieste di creazione | 20 al minuto | Ogni chiave API oppure ogni client OAuth e account, su tutti gli endpoint `POST` |
| Richieste di creazione | 40 al minuto | Ogni account, fra tutte le sue credenziali |
| Richieste di lettura | 120 al minuto | Ogni chiave API oppure ogni client OAuth e account |
| Attività in esecuzione | In base al piano; vedi `GET /credits` | Ogni account, condiviso con il sito |
| Attività per ora | 200 per ora mobile | Ogni account, condiviso con il sito |
| Conversioni raster | 200 al giorno | Ogni account |
| Rilevamenti del testo | 20 ogni 15 minuti | Ogni account, condiviso con il sito |
| Attesa limitata | 30 secondi | Ogni richiesta |

## Gestione di 429

- Le risposte alle richieste che superano autenticazione e verifica dell’ambito includono `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset` per la finestra di richieste più restrittiva. `401` e `403 SCOPE_DENIED` non li includono. Una risposta `429` include `Retry-After` in secondi.
- `429 CONCURRENCY_LIMITED` significa che sono già in esecuzione troppe attività per l’account; quelle completate non contano più. Le cause di `429 RATE_LIMITED` sono elencate sotto.
- Attendi almeno `Retry-After`, aumenta esponenzialmente l’intervallo con una variazione casuale e riprova con lo stesso `Idempotency-Key`.
- I limiti delle attività appartengono all’account: più chiavi non aggiungono capacità.

## Cause di una risposta 429

- Troppe richieste: 20 richieste di creazione al minuto per credenziale, 40 per account e 120 letture al minuto per credenziale. `Retry-After` indica il tempo fino al ripristino della finestra; `details.reason` è assente.
- Sono state avviate troppe attività nell’ultima ora: fino a 200 per account, condivise con il sito. `Retry-After: 30`.
- Sono in esecuzione troppe attività: `429 CONCURRENCY_LIMITED`, in base al piano e condivise con il sito; vedi `GET /credits`. `Retry-After: 30`.
- La quota giornaliera di 200 conversioni gratuite PNG, PDF, TIFF e PPTX è esaurita: `details.reason = DAILY_CONVERSION_LIMIT`, con `Retry-After` fino al ripristino della finestra giornaliera.
- Caricamenti troppo rapidi: `details.reason = UPLOAD_RATE_LIMITED` per immagini e maschere su `POST /files`, allegati di diagrammi di flusso e dati dei grafici. Si applica il limite di caricamento al minuto del sito.
- Troppi caricamenti in un giorno: `details.reason = UPLOAD_DAILY_LIMIT_REACHED` per allegati di diagrammi di flusso e dati dei grafici. Si applica il limite giornaliero di caricamento del sito.
- Rilevamenti del testo: 20 ogni 15 minuti per account, condivisi con il sito.