ข้ามไปยังเนื้อหา
Preview: API ยังอยู่ระหว่างเปิดใช้ รายละเอียดอาจเปลี่ยนก่อนเปิดจริง ดูความคืบหน้าที่ บันทึกการเปลี่ยนแปลง

ขีดจำกัดและโควตา

rate limit คือจำนวนครั้งสูงสุดที่เรียกได้ในช่วงเวลาหนึ่ง ส่วนโควตาคือจำนวนข้อความทั้งเดือนที่บอทใช้ได้ หน้านี้รวมตัวเลขทั้งหมดไว้

ขีดจำกัด ค่า
คำขอ 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

  • คนหนึ่งคนเรียกบอทหนึ่งตัวได้ไม่เกิน 20 ครั้งต่อนาที ครั้งที่เกินจะไม่ถูกส่งไป และไม่นับเข้าโควตาของคุณ
  • ส่ง event ไปที่ webhook พร้อมกันไม่เกิน 2 event ต่อบอท

บอทแต่ละตัวมีโควตาข้อความต่อเดือนตามแพ็กเกจ โดย นับ event ที่ส่งไปที่ webhook รวมกับข้อความที่บอทโพสต์ นับตามเดือนปฏิทินเวลาประเทศไทย และเริ่มนับใหม่ทุกวันที่ 1

แพ็กเกจ ข้อความต่อเดือน ห้องพร้อมกัน เห็นทุกข้อความ
ทั่วไป (ฟรี, ค่าเริ่มต้น) 300 3 ไม่ได้
แพ็กเกจอื่น ตามที่ทีมงาน Sukson กำหนด ตามแพ็กเกจ ตามแพ็กเกจ

ดูค่าจริงของบอทคุณได้จาก GET /v1/me/quota และดูยอดที่ใช้ไปจาก GET /v1/me/quota/consumption ตอนนี้ยังไม่เปิดขายแพ็กเกจ ทีมงานเป็นคนกำหนดให้

เมื่อโควตาหมด บอทจะไม่ได้รับ event ใหม่ และการส่งข้อความจะได้ 403 QUOTA_EXCEEDED ไปจนถึงเดือนถัดไป