I limiti di richiesta controllano il numero di richieste che puoi effettuare a endpoint all'interno di una finestra temporale specifica. Questi limiti aiutano a garantire la stabilità del servizio e a proteggere le risorse di Roblox da abusi.
Scoperta
Ci sono due modi per determinare i limiti di richiesta: la documentazione di riferimento e gli header di risposta.
Pagine di documentazione
I limiti di richiesta pubblici possono essere trovati nella sezione Limiti per ogni endpoint nelle loro pagine di documentazione. Consulta queste sezioni per comprendere i limiti di richiesta che si applicano prima di effettuare richieste.
Ci sforziamo di essere il più trasparenti possibile riguardo ai limiti di richiesta, ma potrebbero applicarsi ulteriori limiti non documentati, inclusi quelli per la protezione DDoS e la stabilità del servizio. Assicurati sempre che la tua applicazione gestisca le risposte HTTP 429 relative ai limiti di richiesta. Vedi Gestione dei limiti di richiesta per indicazioni.
Se incontri un limite di richiesta non documentato che blocca il tuo caso d'uso (o desideri limiti più elevati per un endpoint), ti preghiamo di lasciare un feedback spiegando le tue esigenze nel Forum degli sviluppatori.
Header di risposta
Molte risposte API includono header che forniscono informazioni sullo stato del tuo attuale limite di richiesta.
| Header | Descrizione |
|---|---|
| x-ratelimit-limit | Il numero totale di richieste consentite all'interno della finestra di limite di richiesta. Questo può includere più valori limite per diverse finestre temporali. |
| x-ratelimit-remaining | Il numero di richieste che puoi ancora effettuare con la tua attuale autenticazione. Quando questo raggiunge 0, ricevi risposte HTTP 429. |
| x-ratelimit-reset | Il numero di secondi rimanenti fino a quando la tua quota di limite di richiesta si resetta al limite completo. |
Ecco un esempio di header di limite di richiesta in una risposta API:
In questo esempio:
- Hai 998 richieste rimanenti su un limite totale.
- La tua quota si resetterà in 20 secondi.
Comportamento
Il comportamento del limite di richiesta differisce in base al metodo di autenticazione e all'origine della richiesta, incluso se effettui richieste da un gioco Roblox.
Chiave API
I limiti di richiesta per le chiavi API sono applicati a tutte le chiavi API per proprietario, che può essere un utente o un gruppo. Questi limiti sono applicati in modo coerente indipendentemente da dove provengono le richieste, che siano da HttpService, applicazioni web o altre fonti.
In-game con HttpService
Quando si chiamano endpoint in-game utilizzando HttpService, le richieste contribuiscono anche al limite fisso di 500 richieste HTTP al minuto per ogni server di gioco Roblox. Vedi Richieste HTTP in-game per maggiori dettagli.
OAuth 2.0
I limiti di richiesta di OAuth 2.0 sono applicati per ogni token di accesso. Poiché ogni token di accesso rappresenta una combinazione unica di utente e applicazione, ogni utente che utilizza la tua app riceve la propria quota di limite di richiesta indipendente.
Gestione dei limiti di richiesta
Scrivi il tuo codice per aspettarti e gestire le risposte HTTP 429 (Troppe richieste) dovute a limiti documentati, prevenzione degli abusi o scenari di carico elevato. Quando sei limitato, controlla l'header di risposta retry-after come linea guida su quando riprovare. Se non è presente l'header di risposta retry-after, implementa una strategia di riprovare con backoff esponenziale.