ข้ามไปยังเนื้อหา

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

วิธีที่ BoxHero API จำกัดอัตราคำขอต่อทีม และวิธีรอแล้วลองใหม่

เพื่อให้บริการทำงานได้อย่างเสถียรสำหรับทุกคน BoxHero API จะจำกัดจำนวนคำขอที่แต่ละทีมส่งได้

API โทเค็นทั้งหมดของทีมเดียวกันใช้ขีดจำกัดร่วมกัน การออกโทเค็นเพิ่มในทีมเดียวกันจะไม่ทำให้ขีดจำกัดเพิ่มขึ้น

API จะตอบกลับด้วย 429 และโครงสร้างข้อผิดพลาดที่มี type เป็น /errors/too-many-requests เฮดเดอร์ของการตอบกลับจะบอกว่าคุณลองใหม่ได้เมื่อใด:

เฮดเดอร์คำอธิบาย
Retry-Afterจำนวนวินาทีที่ต้องรอก่อนลองใหม่
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Resetขีดจำกัดปัจจุบัน จำนวนคำขอที่เหลือ และเวลาที่ขีดจำกัดจะรีเซ็ต

ให้รอแล้วลองใหม่หลังจากเวลาที่ระบุใน Retry-After หากต้องส่งคำขอจำนวนมากต่อเนื่องกัน ให้กระจายคำขอออกไปแทนการส่งทั้งหมดพร้อมกัน