Welche sind die Rate Limits?

Derzeit setzen wir keine strikten Limits für Anfragen pro Sekunde durch. Allerdings wird ein fairer Umgang erwartet, um die Servicequalität für alle aufrechtzuerhalten.

Aktueller Ansatz

Statt harter Limits empfehlen wir einen verantwortungsvollen Einsatz:

• Streuen Sie Ihre Anfragen sinnvoll über die Zeit

• Verwenden Sie exponentielles Backoff, wenn Fehler auftreten

• Cachen Sie Antworten, um redundante Aufrufe zu vermeiden

• Kontaktieren Sie uns, wenn Sie mit hohem Traffic rechnen

Best Practices

Stark cachen:

• Speichern Sie Suchergebnisse für gängige Abfragen

• Halten Sie Mediendaten lokal vor, nachdem sie abgerufen wurden

• Rufen Sie /confirm nicht mehrfach für denselben Benutzer/dieselbe Ressource auf

Operationen bündeln:

• Fassen Sie zusammengehörige Anfragen in Gruppen

• Fügen Sie kleine Verzögerungen zwischen den Batches hinzu

• Begrenzen Sie parallele Verbindungen (10–20 ist angemessen)

Fehler sorgfältig behandeln:

• Implementieren Sie Retry-Logik mit exponentiellem Backoff

• Versuchen Sie bei Fehlschlägen nicht sofort erneut

• Protokollieren Sie Fehler zur Überwachung

Erwartete Antwortzeiten

• /resources search: typischerweise 200–500 ms

• /resource details: unter 100 ms

• /confirm licensing: 300–800 ms

Setzen Sie die Timeout-Zeit Ihres Clients auf mindestens 30 Sekunden, um gelegentlich langsamere Antworten zu berücksichtigen.

Wenn Sie Limits erreichen

Sie erhalten einen 429 Too Many Requests-Fehler. Wenn das passiert:

// Implement exponential backoff
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      
      if (response.status === 429) {
        const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, waitTime));
        continue;
      }
      
      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

Überwachen Sie Ihre Nutzung

Verfolgen Sie die API-Aktivität in Einstellungen → API:

• Sehen Sie die insgesamt gemachten Anfragen

• Prüfen Sie aktive Lizenzen

• Bewerten Sie Nutzungstrends

• Beobachten Sie ungewöhnliche Muster

Benötigen Sie höhere Limits?

Wenn Ihr legitimer Anwendungsfall hohe Anfragevolumen erfordert (>1 Mio. Anfragen/Monat), kontaktieren Sie unser Team, um Folgendes zu besprechen:

• Ihre Anwendung und Ihre Traffic-Muster

• Das erwartete Anfragevolumen

• Garantierte Rate Limits, falls erforderlich