Riferimento API
Limiti delle richieste e della concorrenza
Limiti delle richieste, limiti delle attività e gestione di 429.
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-RemainingeX-RateLimit-Resetper la finestra di richieste più restrittiva.401e403 SCOPE_DENIEDnon li includono. Una risposta429includeRetry-Afterin secondi. 429 CONCURRENCY_LIMITEDsignifica che sono già in esecuzione troppe attività per l’account; quelle completate non contano più. Le cause di429 RATE_LIMITEDsono elencate sotto.- Attendi almeno
Retry-After, aumenta esponenzialmente l’intervallo con una variazione casuale e riprova con lo stessoIdempotency-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-Afterindica 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; vediGET /credits.Retry-After: 30. - La quota giornaliera di 200 conversioni gratuite PNG, PDF, TIFF e PPTX è esaurita:
details.reason = DAILY_CONVERSION_LIMIT, conRetry-Afterfino al ripristino della finestra giornaliera. - Caricamenti troppo rapidi:
details.reason = UPLOAD_RATE_LIMITEDper immagini e maschere suPOST /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_REACHEDper 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.