Rate Limits
Rate Limits gewährleisten eine faire Nutzung und optimale Leistung der grapeminds API für alle Nutzer.
Zur Sicherung der Plattformstabilität wird die KI-Hintergrundanreicherung pro API-Schlüssel und global gedrosselt. API-Antworten bleiben verfügbar; die Anreicherung kann bei Lastspitzen verzögert erfolgen.
Aktuelle Limits
| Plan | Anfragen / Minute | Anfragen / Monat |
|---|---|---|
| Free | 60 | 250 |
| Developer | 1.200 | 10.000 |
| Startup | 1.200 | 100.000 |
| Enterprise | Individuell | Individuell |
Rate Limit Headers
Jede API-Antwort enthält Headers, die Ihnen helfen, Ihr verbleibendes Kontingent zu verfolgen:
X-RateLimit-Limit
Die maximale Anzahl erlaubter Anfragen pro Minute.
X-RateLimit-Remaining
Die Anzahl der verbleibenden Anfragen im aktuellen Zeitfenster.
X-Monthly-Limit
Das monatliche Anfragekontingent Ihres Plans oder „unlimited".
X-Monthly-Used
Im laufenden Kalendermonat verbrauchte Anfragen (UTC).
X-Monthly-Remaining
Verbleibende Anfragen, bis das Monatskontingent erschöpft ist.
Retry-After
Sekunden bis zum nächsten Versuch (nur vorhanden bei Rate Limiting).
Das Monatskontingent gilt für alle API-Keys Ihres Kontos gemeinsam und wird zu Beginn jedes Kalendermonats (UTC) zurückgesetzt. Bei Überschreitung antwortet die API mit 429 und einem Retry-After bis zum Zurücksetzen.
Wenn Sie das Limit erreichen
Wenn Sie das Rate Limit überschreiten, erhalten Sie eine 429-Antwort:
Too Many Requests
{
"message": "Too Many Attempts.",
"retry_after": 30
}Best Practices
Cachen Sie Antworten, wo möglich, um die Anzahl der API-Aufrufe zu reduzieren.
Implementieren Sie exponentielles Backoff bei 429-Fehlern.
Überwachen Sie den X-RateLimit-Remaining-Header, um Limits proaktiv zu vermeiden.
Verwenden Sie Paginierung, um Daten in kleineren Batches abzurufen, statt große Datensätze anzufordern.
Richtlinien zur zulässigen Nutzung
Die API ist ausschließlich für Integrationszwecke bestimmt – zur Anzeige oder Verarbeitung von Weindaten innerhalb Ihrer eigenen Anwendung.
Die folgenden Nutzungen der API sind ausdrücklich verboten:
Scraping, Crawling, Spidering oder systematisches Massenherunterladen von Daten
Aufbau oder Anreicherung externer Datenbanken, Datenprodukte oder Datensätze
Training von KI- oder maschinellen Lernmodellen mit API-Daten
Automatisierter sequenzieller oder alphabetischer Abruf von Ressourcen
Jede Nutzung, die die API-Leistung oder -Verfügbarkeit für andere Nutzer beeinträchtigt
Verstöße können zur vorübergehenden oder dauerhaften Sperrung Ihres API-Schlüssels ohne vorherige Ankündigung führen.
Höhere Limits benötigt?
Kontaktieren Sie uns für einen individuellen Enterprise-Plan mit höheren Rate Limits.