ขีดจำกัดอัตรา

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ขีดจำกัดอัตราควบคุมจำนวนคำขอที่คุณสามารถส่งไปยังปลายทางภายในกรอบเวลาเฉพาะ ขีดจำกัดเหล่านี้ช่วยให้บริการมีเสถียรภาพและปกป้องทรัพยากรของ Roblox จากการใช้ในทางที่ผิด

การค้นหา

มีสองวิธีในการกำหนดขีดจำกัดอัตรา: เอกสารอ้างอิงและส่วนหัวการตอบสนอง

หน้าส่วนเอกสาร

ขีดจำกัดอัตราสาธารณะสามารถพบได้ในส่วน ขีดจำกัด สำหรับแต่ละปลายทางในหน้าส่วนเอกสารของพวกเขา ดูส่วนเหล่านี้เพื่อเข้าใจขีดจำกัดอัตราที่ใช้บังคับก่อนที่จะส่งคำขอ

เราพยายามให้ข้อมูลเกี่ยวกับขีดจำกัดอัตราอย่างโปร่งใสที่สุดเท่าที่จะเป็นไปได้ แต่ขีดจำกัดเพิ่มเติมที่ไม่ได้เอกสารอาจมีผลบังคับใช้ รวมถึงสำหรับการป้องกัน DDoS และเสถียรภาพของบริการ ตรวจสอบให้แน่ใจว่าแอปพลิเคชันของคุณจัดการกับการตอบสนอง HTTP 429 ที่จำกัดอัตรา ดู การจัดการขีดจำกัดอัตรา สำหรับแนวทาง

หากคุณประสบปัญหาขีดจำกัดอัตราที่ไม่ได้บันทึกซึ่งขัดขวางกรณีการใช้งานของคุณ (หรือต้องการขีดจำกัดที่สูงขึ้นสำหรับปลายทาง) กรุณาแสดงข้อเสนอแนะแบบอธิบายความต้องการของคุณใน Developer Forum

ส่วนหัวการตอบสนอง

การตอบสนอง API หลายรายการประกอบด้วยส่วนหัวที่ให้ข้อมูลเกี่ยวกับสถานะขีดจำกัดอัตราปัจจุบันของคุณ

ส่วนหัว	คำอธิบาย
x-ratelimit-limit	จำนวนคำขอทั้งหมดที่อนุญาตภายในกรอบเวลาจำกัดอัตรา ซึ่งอาจรวมถึงค่าขีดจำกัดหลายค่า สำหรับกรอบเวลาแตกต่างกัน
x-ratelimit-remaining	จำนวนคำขอที่คุณยังสามารถส่งได้ด้วยการพิสูจน์ตัวตนปัจจุบันของคุณ เมื่อถึง 0 คุณจะได้รับการตอบสนอง HTTP 429
x-ratelimit-reset	จำนวนวินาทีที่เหลือจนกว่าสิทธิ์ในการจำกัดอัตราของคุณจะตั้งค่าเป็นขีดจำกัดทั้งหมด

นี่คือตัวอย่างของส่วนหัวการจำกัดอัตราในการตอบสนอง API:


x-ratelimit-limit: 1000, 1000;w=60, 1000;w=60
x-ratelimit-remaining: 998
x-ratelimit-reset: 20

ในตัวอย่างนี้:

คุณมีคำขอเหลือ 998 คำขอจากขีดจำกัดทั้งหมดของคุณ
โควต้าของคุณจะรีเซ็ตใน 20 วินาที

พฤติกรรม

พฤติกรรมการจำกัดอัตราจะแตกต่างกันไปตามวิธีการพิสูจน์ตัวตนและแหล่งที่มาของคำขอ รวมถึงว่าคุณทำการส่งคำขอจากภายในเกม Roblox หรือไม่

API key

ขีดจำกัดอัตราสำหรับ API keys จะใช้บังคับกับ API keys ทุกตัวต่อลิขสิทธิ์ ซึ่งสามารถเป็นได้ทั้งผู้ใช้หรือกลุ่ม ขีดจำกัดเหล่านี้จะบังคับใช้อย่างสม่ำเสมอไม่ว่าจะมีแหล่งที่มาจากที่ใด—ไม่ว่าจะมาจาก HttpService, แอปพลิเคชันเว็บ หรือแหล่งข้อมูลอื่น

ในเกมด้วย HttpService

เมื่อเรียกปลายทางในเกมโดยใช้ HttpService คำขอจะมีส่วนช่วยในการจำกัดที่แน่นอนที่ 500 คำขอ HTTP ต่อหนึ่งนาทีต่อเซิร์ฟเวอร์เกม Roblox ดู การส่งคำขอ HTTP ในเกม สำหรับรายละเอียดเพิ่มเติม

OAuth 2.0

ขีดจำกัดอัตราสำหรับ OAuth 2.0 จะใช้บังคับต่อหนึ่ง access token ตั้งแต่ละ access token แทนที่การรวมกันที่ไม่ซ้ำกันของผู้ใช้และแอปพลิเคชัน ผู้ใช้ทุกคนที่ใช้แอปพลิเคชันของคุณจะได้รับโควต้าการจำกัดอัตราเป็นรายบุคคล

การจัดการขีดจำกัดอัตรา

เขียนโค้ดของคุณให้คาดหวังและจัดการกับการตอบสนอง HTTP 429 (Too Many Requests) เนื่องจากขีดจำกัดที่บันทึกไว้ การป้องกันการใช้ในทางที่ผิด หรือสถานการณ์ที่มีการใช้งานสูง เมื่อจำกัดอัตรา ตรวจสอบส่วนหัวการตอบสนอง retry-after เป็นแนวทางสำหรับเวลาที่จะลองส่งคำขออีกครั้ง หากไม่มีส่วนหัวการตอบสนอง retry-after ให้ใช้กลยุทธ์การพยายามซ้ำแบบ exponential backoff

ภาษาไทย