Limiti di Utilizzo

AstroAPI applica limiti di utilizzo per garantire un uso equo e la stabilità della piattaforma.

Limiti Predefiniti

I limiti di utilizzo sono determinati dal tuo piano di abbonamento:

Abbonamento	Richieste/minuto	Richieste/mese
Basic	60	150.000
Gold	120	300.000
Premium	300	750.000
Deluxe	600	1.000.000

I tuoi limiti specifici dipendono dal tuo abbonamento attivo. Controlla la dashboard per i tuoi limiti attuali.

Intestazioni dei Limiti di Utilizzo

Tutte le risposte includono informazioni sui limiti di utilizzo:

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

Gestione dei Limiti di Utilizzo

Quando superi il limite di utilizzo, l'API restituisce una risposta 429 Too Many Requests:

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

Strategia di Retry

Implementa un backoff esponenziale quando ricevi risposte 429:

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');
}

Limiti Specifici per Endpoint

Alcuni endpoint hanno limiti aggiuntivi:

Endpoint	Limite Aggiuntivo
/api/chart/*	100 rendering/ora
/api/calc/batch	10 richieste batch/minuto

Aumento dei Limiti

Contatta il supporto per discutere limiti di utilizzo personalizzati per la tua applicazione.