ขีดจำกัดและโควตา
rate limit คือจำนวนครั้งสูงสุดที่เรียกได้ในช่วงเวลาหนึ่ง ส่วนโควตาคือจำนวนข้อความทั้งเดือนที่บอทใช้ได้ หน้านี้รวมตัวเลขทั้งหมดไว้
การเรียก API
หัวข้อที่มีชื่อว่า “การเรียก API”| ขีดจำกัด | ค่า |
|---|---|
| คำขอ API ต่อบอท (ทุก endpoint รวมกัน) | 120 ครั้งต่อนาที เรียกติดกันได้สูงสุด 20 ครั้ง |
| ขนาด body | 64 KB |
ทุกคำตอบของคำขอที่ผ่านการยืนยันตัวตนแล้วมีหัว X-RateLimit-Limit, X-RateLimit-Remaining และ X-RateLimit-Reset บอกว่าเรียกได้อีกเท่าไร (คำตอบ 401 INVALID_TOKEN และ 403 BOT_DISABLED ไม่มีหัวเหล่านี้)
ถ้าเรียกเกิน จะได้ 429 RATE_LIMITED พร้อมหัว Retry-After และ details.retry_after (เป็นวินาที) ให้รอตามเวลานั้นแล้วค่อยลองใหม่ การลองถี่ขึ้นไม่ช่วยอะไร
การส่งข้อความ
หัวข้อที่มีชื่อว่า “การส่งข้อความ”| ขีดจำกัด | ค่า |
|---|---|
| ต่อห้อง | 6 ข้อความต่อ 10 วินาที และ 20 ข้อความต่อนาที |
| ในช่อง (channel) | 10 ข้อความต่อชั่วโมง |
| ต่อบอท รวมทุกห้อง | 60 ข้อความต่อนาที |
| ข้อความต่อคำขอ | 5 |
| ความยาวข้อความ | 4,096 ตัวอักษร |
นับทุกข้อความที่บอทโพสต์ ไม่ว่าจะส่งด้วย {"reply"}, reply token หรือ push ห้องที่เปิด slow mode (โหมดจำกัดความถี่การส่ง) อาจได้ 429 SLOW_MODE
Event ที่บอทได้รับ
หัวข้อที่มีชื่อว่า “Event ที่บอทได้รับ”- คนหนึ่งคนเรียกบอทหนึ่งตัวได้ไม่เกิน 20 ครั้งต่อนาที ครั้งที่เกินจะไม่ถูกส่งไป และไม่นับเข้าโควตาของคุณ
- ส่ง event ไปที่ webhook พร้อมกันไม่เกิน 2 event ต่อบอท
โควตารายเดือน
หัวข้อที่มีชื่อว่า “โควตารายเดือน”บอทแต่ละตัวมีโควตาข้อความต่อเดือนตามแพ็กเกจ โดย นับ event ที่ส่งไปที่ webhook รวมกับข้อความที่บอทโพสต์ นับตามเดือนปฏิทินเวลาประเทศไทย และเริ่มนับใหม่ทุกวันที่ 1
| แพ็กเกจ | ข้อความต่อเดือน | ห้องพร้อมกัน | เห็นทุกข้อความ |
|---|---|---|---|
| ทั่วไป (ฟรี, ค่าเริ่มต้น) | 300 | 3 | ไม่ได้ |
| แพ็กเกจอื่น | ตามที่ทีมงาน Sukson กำหนด | ตามแพ็กเกจ | ตามแพ็กเกจ |
ดูค่าจริงของบอทคุณได้จาก GET /v1/me/quota และดูยอดที่ใช้ไปจาก GET /v1/me/quota/consumption ตอนนี้ยังไม่เปิดขายแพ็กเกจ ทีมงานเป็นคนกำหนดให้
เมื่อโควตาหมด บอทจะไม่ได้รับ event ใหม่ และการส่งข้อความจะได้ 403 QUOTA_EXCEEDED ไปจนถึงเดือนถัดไป