Hız limitleri, belirli bir zaman diliminde uç noktalara yapabileceğiniz istek sayısını kontrol eder. Bu limitler, hizmetin istikrarını sağlamaya ve Roblox kaynaklarını kötüye kullanımdan korumaya yardımcı olur.
Keşif
Hız limitlerini belirlemenin iki yolu vardır: referans belgesi ve yanıt başlıkları.
Belge sayfaları
Genel hız limitleri, her bir uç noktanın belge sayfalarında Limitler bölümünde bulunabilir. İstek yapmadan önce geçerli olan hız limitlerini anlamak için bu bölümlere göz atın.
Hız limitleri hakkında mümkün olduğunca şeffaf olmaya çalışıyoruz, ancak DDos koruması ve hizmetin istikrarı gibi ek, belgelenmemiş limitler de uygulanabilir. Uygulamanızın HTTP 429 hız sınırlama yanıtlarını ele aldığından her zaman emin olun. Daha fazla bilgi için Hız limitlerini ele alma sayfasına bakın.
Belgelenmemiş bir hız limitine ulaşırsanız (ya da bir uç nokta için daha yüksek limitler istiyorsanız), ihtiyaçlarınızı açıklayan geri bildirim bırakmak için Geliştirici Forumu kullanın.
Yanıt başlıkları
Birçok API yanıtı, mevcut hız limit durumunuz hakkında bilgi sağlayan başlıklar içerir.
| Başlık | Açıklama |
|---|---|
| x-ratelimit-limit | Hız limit penceresi içinde izin verilen toplam istek sayısı. Bu, farklı zaman dilimleri için birden fazla limit değerini içerebilir. |
| x-ratelimit-remaining | Mevcut kimlik doğrulamanızla hala yapabileceğiniz istek sayısı. Bu 0'a ulaştığında, HTTP 429 yanıtları alırsınız. |
| x-ratelimit-reset | Hız limit kotanızın tamamen sıfırlanmasına kalan süre (saniye cinsinden). |
Bir API yanıtındaki hız limit başlıklarına bir örnek:
Bu örnekte:
- Toplam limitinizden 998 isteğiniz kaldı.
- Kotanız 20 saniye içinde sıfırlanacak.
Davranış
Hız limit davranışı, kimlik doğrulama yöntemi ve istek kaynağına göre değişir; bu, isteklerinizi bir Roblox oyunundan yapıp yapmadığını da içerir.
API anahtarı
API anahtarları için hız limitleri, ya bir kullanıcı ya da bir grup olan her sahip için tüm API anahtarları arasında uygulanır. Bu limitler, isteklerin nereden geldiğine bakılmaksızın tutarlı bir şekilde uygulanır—ister HttpService üzerinden, ister web uygulamalarından ya da diğer kaynaklardan olsun.
Oyun içinde HttpService ile
HttpService kullanarak oyun içindeki uç noktalara çağrıda bulunduğunuzda, istekler aynı zamanda her Roblox oyun sunucusu için dakikada 500 HTTP isteği olan sabit limite de katkıda bulunur. Daha fazla bilgi için Oyun içi HTTP istekleri sayfasına bakın.
OAuth 2.0
OAuth 2.0 hız limitleri, her erişim belirteci başına uygulanır. Her erişim belirteci, kullanıcı ve uygulamanın benzersiz bir kombinasyonunu temsil ettiğinden, uygulamanızı kullanan her kullanıcı kendi bağımsız hız limiti kotasını alır.
Hız limitlerini ele alma
Kodunuzu, belgelenmiş limitler, kötüye kullanım önleme veya yüksek yük senaryoları nedeniyle HTTP 429 (Çok Fazla İstek) yanıtlarını bekleyecek ve işleyecek şekilde yazın. Hız sınırına ulaştığınızda, yeniden denemek için bir kılavuz olarak retry-after yanıt başlığına bakın. Eğer retry-after yanıt başlığı yoksa, bir eksponansiyel geri çekilme (backoff) yeniden deneme stratejisi uygulayın.