Giới hạn tỷ lệ kiểm soát số lượng yêu cầu mà bạn có thể gửi đến các điểm cuối trong một khoảng thời gian cụ thể. Những giới hạn này giúp đảm bảo tính ổn định của dịch vụ và bảo vệ tài nguyên của Roblox khỏi lạm dụng.
Khám phá
Có hai cách để xác định giới hạn tỷ lệ: tài liệu tham khảo và tiêu đề phản hồi.
Trang tài liệu
Giới hạn tỷ lệ công khai có thể được tìm thấy trong phần Giới hạn cho mỗi điểm cuối trên các trang tài liệu của họ. Xem các phần này để hiểu rõ các giới hạn tỷ lệ áp dụng trước khi thực hiện yêu cầu.
Chúng tôi cố gắng cung cấp thông tin minh bạch nhất có thể về giới hạn tỷ lệ, nhưng có thể có các giới hạn chưa được tài liệu hóa khác, bao gồm bảo vệ DDoS và tính ổn định của dịch vụ. Hãy đảm bảo ứng dụng của bạn xử lý các phản hồi giới hạn tỷ lệ HTTP 429. Xem Xử lý giới hạn tỷ lệ để biết hướng dẫn.
Nếu bạn gặp phải một giới hạn tỷ lệ chưa được tài liệu hóa ngăn cản trường hợp sử dụng của bạn (hoặc bạn muốn giới hạn cao hơn cho một điểm cuối), hãy để lại phản hồi giải thích nhu cầu của bạn trên Diễn đàn Nhà phát triển.
Tiêu đề phản hồi
Nhiều phản hồi API bao gồm các tiêu đề cung cấp thông tin về tình trạng giới hạn tỷ lệ hiện tại của bạn.
| Tiêu đề | Mô tả |
|---|---|
| x-ratelimit-limit | Tổng số yêu cầu được phép trong khoảng thời gian giới hạn tỷ lệ. Điều này có thể bao gồm nhiều giá trị giới hạn cho các khoảng thời gian khác nhau. |
| x-ratelimit-remaining | Số lượng yêu cầu bạn vẫn có thể thực hiện với xác thực hiện tại. Khi điều này đạt 0, bạn sẽ nhận được phản hồi HTTP 429. |
| x-ratelimit-reset | Số giây còn lại cho đến khi hạn ngạch giới hạn tỷ lệ của bạn được đặt lại về giới hạn đầy đủ. |
Dưới đây là ví dụ về các tiêu đề giới hạn tỷ lệ trong phản hồi API:
Trong ví dụ này:
- Bạn còn 998 yêu cầu trong tổng số giới hạn của bạn.
- Hạn ngạch của bạn sẽ được đặt lại trong vòng 20 giây.
Hành vi
Hành vi giới hạn tỷ lệ khác nhau tùy thuộc vào phương thức xác thực và nguồn gốc yêu cầu, bao gồm việc bạn thực hiện yêu cầu từ trong một trò chơi Roblox.
Khóa API
Các giới hạn tỷ lệ cho khóa API được áp dụng cho tất cả các khóa API của từng chủ sở hữu, có thể là người dùng hoặc nhóm. Những giới hạn này được thi hành một cách nhất quán bất kể yêu cầu xuất phát từ đâu—cho dù từ HttpService, ứng dụng web, hoặc các nguồn khác.
Trong trò chơi với HttpService
Khi gọi các điểm cuối trong trò chơi bằng cách sử dụng HttpService, các yêu cầu cũng góp phần vào giới hạn cố định là 500 yêu cầu HTTP mỗi phút cho mỗi máy chủ trò chơi Roblox. Xem Yêu cầu HTTP trong trò chơi để biết thêm chi tiết.
OAuth 2.0
Các giới hạn tỷ lệ OAuth 2.0 được áp dụng theo mã truy cập. Vì mỗi mã truy cập đại diện cho một sự kết hợp độc đáo giữa người dùng và ứng dụng, mỗi người dùng sử dụng ứng dụng của bạn nhận được hạn ngạch giới hạn tỷ lệ độc lập của riêng họ.
Xử lý giới hạn tỷ lệ
Viết mã của bạn để kỳ vọng và xử lý phản hồi HTTP 429 (Quá nhiều yêu cầu) do các giới hạn được tài liệu hóa, ngăn chặn lạm dụng, hoặc các tình huống tải cao. Khi bị giới hạn tỷ lệ, hãy kiểm tra tiêu đề phản hồi retry-after như một hướng dẫn về thời điểm thử lại. Nếu không có tiêu đề phản hồi retry-after, hãy thực hiện một chiến lược thử lại theo kiểu tăng dần.