Ratenbegrenzungen

AstroAPI setzt Ratenbegrenzungen durch, um eine faire Nutzung und die Stabilität der Plattform sicherzustellen.

Standardgrenzen

Die Ratenbegrenzungen werden durch Ihr Abonnementplan bestimmt:

Abonnement	Anfragen/Minute	Anfragen/Monat
Basic	60	150.000
Gold	120	300.000
Premium	300	750.000
Deluxe	600	1.000.000

Ihre spezifischen Ratenbegrenzungen hängen von Ihrem aktiven Abonnement ab. Überprüfen Sie Ihre aktuellen Grenzen im Dashboard.

Ratenbegrenzungs-Header

Alle Antworten enthalten Informationen zur Ratenbegrenzung:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1699999999

Umgang mit Ratenbegrenzungen

Wenn Sie die Ratenbegrenzung überschreiten, gibt die API eine 429 Too Many Requests-Antwort zurück:

{
  "errors": [{
    "status": "429",
    "title": "Too Many Requests",
    "detail": "Rate limit exceeded. Please retry after 60 seconds."
  }]
}

Wiederholungsstrategie

Implementieren Sie exponentielles Backoff bei 429-Antworten:

async function fetchWithRetry(url: string, options: RequestInit, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) {
      return response;
    }

    const retryAfter = response.headers.get('Retry-After') || '60';
    await new Promise(resolve =>
      setTimeout(resolve, parseInt(retryAfter) * 1000)
    );
  }

  throw new Error('Max retries exceeded');
}

Endpunkt-spezifische Grenzen

Einige Endpunkte haben zusätzliche Grenzen:

Endpunkt	Zusätzliche Grenze
/api/chart/*	100 Darstellungen/Stunde
/api/calc/batch	10 Batch-Anfragen/Minute

Grenzen erhöhen

Kontaktieren Sie den Support, um benutzerdefinierte Ratenbegrenzungen für Ihre Anwendung zu besprechen.