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 / Giorno |
|---|---|---|
| Prova (14 giorni) | 60 | 1.000 |
| Standard | 120 | 10.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.
Retry-After
Secondi da attendere prima di riprovare (presente solo in caso di limitazione).
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.