Limiti di velocità
I limiti di richiesta garantiscono un utilizzo equo e prestazioni ottimali dell'API grapeminds per tutti gli utenti.
Per garantire la stabilità della piattaforma, l'arricchimento IA in background è limitato per chiave API e a livello globale. Le risposte API restano disponibili; l'arricchimento può subire ritardi nei picchi di carico.
Limiti attuali
| Piano | Richieste / Minuto | Richieste / mese |
|---|---|---|
| Free | 60 | 250 |
| Developer | 1.200 | 10.000 |
| Startup | 1.200 | 100.000 |
| Enterprise | Personalizzato | Personalizzato |
Header dei limiti
Ogni risposta API include header per aiutarvi a monitorare la vostra quota rimanente:
X-RateLimit-Limit
Il numero massimo di richieste consentite al minuto.
X-RateLimit-Remaining
Il numero di richieste rimanenti nella finestra attuale.
X-Monthly-Limit
La quota mensile di richieste del tuo piano, oppure "unlimited".
X-Monthly-Used
Richieste consumate nel mese di calendario corrente (UTC).
X-Monthly-Remaining
Richieste rimanenti prima di esaurire la quota mensile.
Retry-After
Secondi da attendere prima di riprovare (presente solo in caso di limitazione).
La quota mensile è condivisa da tutte le chiavi API del tuo account e si azzera all'inizio di ogni mese di calendario (UTC). Al superamento l'API risponde 429 con un Retry-After fino all'azzeramento.
Quando raggiungete il limite
Se superate il limite di richiesta, riceverete una risposta 429:
Too Many Requests
{
"message": "Too Many Attempts.",
"retry_after": 30
}Migliori pratiche
Memorizzate le risposte nella cache dove possibile per ridurre il numero di chiamate API.
Implementate un backoff esponenziale in caso di errori 429.
Monitorate l'header X-RateLimit-Remaining per evitare proattivamente di raggiungere i limiti.
Usate la paginazione per recuperare i dati in lotti più piccoli invece di richiedere grandi set di dati.
Politica di utilizzo accettabile
L'API è destinata esclusivamente a scopi di integrazione – per visualizzare o elaborare dati vinicoli all'interno della propria applicazione.
I seguenti utilizzi dell'API sono severamente vietati:
Scraping, crawling, spidering o download massivo e sistematico di dati
Creazione o arricchimento di database esterni, prodotti dati o set di dati
Addestramento di modelli di intelligenza artificiale o di machine learning utilizzando i dati dell'API
Accesso automatizzato alle risorse in modo sequenziale o alfabetico
Qualsiasi utilizzo che comprometta le prestazioni o la disponibilità dell'API per altri utenti
Le violazioni possono comportare la sospensione temporanea o permanente della chiave API senza preavviso.
Servono limiti più alti?
Contattateci per un piano Enterprise personalizzato con limiti più elevati.