Snelheidslimieten beheersen het aantal verzoeken dat je kunt doen naar eindpunten binnen een specifieke tijdsperiode. Deze limieten helpen de stabiliteit van de service te waarborgen en beschermen de Roblox-resources tegen misbruik.
Ontdekking
Er zijn twee manieren om snelheidslimieten te bepalen: de referentiedocumentatie en de response headers.
Documentatiepagina's
Openbare snelheidslimieten zijn te vinden onder de sectie Limieten voor elk eindpunt op hun documentatiepagina's. Bekijk deze secties om de snelheidslimieten te begrijpen die van toepassing zijn voordat je verzoeken indient.
We streven ernaar zo transparant mogelijk te zijn over snelheidslimieten, maar er kunnen aanvullende, niet gedocumenteerde limieten van toepassing zijn, inclusief voor DDoS-bescherming en service-stabiliteit. Zorg er altijd voor dat je applicatie HTTP 429-snelheidslimietreacties afhandelt. Zie Omgaan met snelheidslimieten voor richtlijnen.
Als je een niet gedocumenteerde snelheidslimiet tegenkomt die je gebruiksgeval blokkeert (of als je hogere limieten voor een eindpunt wilt), laat dan feedback achter waarin je jouw behoeften uitlegt in het Developer Forum.
Response headers
Veel API-responses bevatten headers die informatie geven over je huidige status van de snelheidslimiet.
| Header | Beschrijving |
|---|---|
| x-ratelimit-limit | Het totale aantal verzoeken dat is toegestaan binnen de snelheidslimietperiode. Dit kan meerdere limietwaarden voor verschillende tijdsperioden omvatten. |
| x-ratelimit-remaining | Het aantal verzoeken dat je nog kunt doen met je huidige authenticatie. Wanneer dit 0 bereikt, ontvang je HTTP 429-reacties. |
| x-ratelimit-reset | Het aantal seconden dat nog resteert totdat je snelheidslimietquotum opnieuw wordt ingesteld op de volledige limiet. |
Hier is een voorbeeld van snelheidslimietheaders in een API-respons:
x-ratelimit-limit: 1000, 1000;w=60, 1000;w=60
x-ratelimit-remaining: 998
x-ratelimit-reset: 20In dit voorbeeld:
- Je hebt 998 verzoeken over van je totale limiet.
- Je quotum wordt over 20 seconden opnieuw ingesteld.
Gedrag
Het gedrag van snelheidslimieten verschilt per authenticatiemethode en verzoekoorsprong, inclusief of je verzoeken doet vanuit een Roblox-spel.
API-sleutel
Snelheidslimieten voor API-sleutels worden toegepast op alle API-sleutels per eigenaar, wat een gebruiker of een groep kan zijn. Deze limieten worden consistent gehandhaafd, ongeacht waar de verzoeken vandaan komen—of het nu vanuit HttpService, webapplicaties of andere bronnen is.
In-game met HttpService
Wanneer je eindpunten in-game aanroept met HttpService, dragen verzoeken ook bij aan de vaste limiet van 500 HTTP-verzoeken per minuut per Roblox-spelserver. Zie In-game HTTP-verzoeken voor meer details.
OAuth 2.0
Snelheidslimieten voor OAuth 2.0 worden per toegangstoken toegepast. Aangezien elke toegangstoken een unieke combinatie van gebruiker en applicatie vertegenwoordigt, ontvangt elke gebruiker die jouw app gebruikt zijn eigen onafhankelijke snelheidslimietquotum.
Omgaan met snelheidslimieten
Schrijf je code zodat deze HTTP 429 (Te Veel Verzoeken) reacties verwacht en afhandelt als gevolg van gedocumenteerde limieten, misbruikpreventie of hoge belastingscenario's. Wanneer je beperkt bent in snelheid, controleer dan de retry-after response header als richtlijn voor wanneer je opnieuw moet proberen. Als er geen retry-after response header aanwezig is, implementeer dan een exponentiële backoff retry-strategie.