ขีดจำกัดและขนาด

เพื่อให้แพลตฟอร์มมีเสถียรภาพ API จึงมีข้อจำกัดด้านความถี่คำร้องและขนาดข้อมูลที่ส่ง

ความถี่คำร้อง

เมื่อเกินความถี่ที่อนุญาต เซิร์ฟเวอร์จะตอบกลับด้วยโค้ด 429 Too Many Requests วิธีจัดการที่ถูกต้องคือการลองใหม่ด้วย Exponential Backoff: เพิ่มช่วงเวลาระหว่างการลองใหม่และอย่าส่งคำร้องแบบต่อเนื่องหนาแน่น กระจายการดำเนินการแบบ Bulk ออกไปตามเวลาและใช้โทเค็นเดียวแบบลำดับ ไม่ใช่แบบ Parallel Burst

ขนาด Body ของคำร้อง

สำหรับ REST คำร้องทั่วไป ขนาด JSON Body จำกัดที่ 2 MiB เพียงพอสำหรับการกำหนดค่าของรีแอคชัน, คอลเลกชัน และการตั้งค่าทุกประเภท หาก Body ใหญ่กว่านั้นให้แบ่งการดำเนินการออกเป็นส่วนๆ (เช่น นำเข้ารีแอคชันเป็น Batch)

ขนาด Body สำหรับการนำเข้า

Endpoint สำหรับนำเข้าออกแบบมาสำหรับ Bundle ขนาดใหญ่และมีขีดจำกัดที่สูงกว่า: สูงสุด 64 MiB สำหรับการนำเข้าข้อมูล และสูงสุด 256 MiB สำหรับการนำเข้าพร้อมสื่อแนบ หาก Bundle ใหญ่กว่านั้นให้แบ่งเป็นหลายการนำเข้า

เกินขีดจำกัด

  • เกินขีดจำกัดความถี่ — 429 ลองใหม่ด้วย Delay
  • Body ใหญ่กว่าที่อนุญาต — คำร้องถูกปฏิเสธ (413 หรือ 400 ขึ้นอยู่กับ Endpoint) ลดขนาดหรือแบ่ง Payload

ขั้นตอนถัดไป