> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/th/developers/api/rate-limiting.md).

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

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

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

## ขีดจำกัดเป็นแบบต่อทีม

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

## เมื่อถึงขีดจำกัด

API จะตอบกลับด้วย `429` และ[โครงสร้างข้อผิดพลาด](https://www.boxhero.io/docs/th/developers/api/errors)ที่มี `type` เป็น `/errors/too-many-requests` เฮดเดอร์ของการตอบกลับจะบอกว่าคุณลองใหม่ได้เมื่อใด:

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

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

> **Note**
>
> ขีดจำกัดอาจเปลี่ยนแปลงได้ ให้อ่านค่าจากเฮดเดอร์ของการตอบกลับแทนการกำหนดอัตราตายตัวไว้ในไคลเอนต์ของคุณ