คําขอแบบกลุ่ม

custombatch เป็นเมธอดทั่วไปที่ช่วยให้คุณจัดกลุ่มการเรียก API หลายรายการหรือที่เรียกว่า "รายการ" ไว้ในคําขอ HTTP เดียว แต่ละรายการจะอ้างอิงการเรียกใช้เมธอดรายการเดียวเท่านั้น

การทดสอบเป็นกลุ่มที่กําหนดเองเป็นตัวเลือกที่เหมาะสําหรับกรณีต่อไปนี้

  • คุณเพิ่งเริ่มใช้ API และมีข้อมูลผลิตภัณฑ์จำนวนมากที่จะอัปโหลด
  • คุณต้องซิงค์ข้อมูลในเครื่องกับเซิร์ฟเวอร์โดยการส่งการอัปเดตและการลบจำนวนมาก

ส่งคําขอแบบเป็นกลุ่ม

การส่งคําขอแบบเป็นกลุ่มคล้ายกับการส่งการเรียก API พร้อมกัน โปรดทราบว่าเราไม่รับประกันว่าลําดับของรายการที่กําหนดไว้ในคําขอจะอยู่ในลําดับที่ดําเนินการ เราขอแนะนําว่าอย่าใช้การเรียกแบบพึ่งพากันในคําขอกลุ่มเดียว (เช่น การสร้างและการอัปเดตการจัดส่งเดียวกัน)

ในทํานองเดียวกัน การตอบกลับที่ได้รับสําหรับคําขอแบบเป็นกลุ่มอาจแสดงผลในลําดับที่แตกต่างจากรายการคําขอ คุณสามารถใช้ BatchId เพื่อเชื่อมโยงคำขอและคำตอบ เนื่องจากคำตอบอาจแสดงผลไม่เป็นลำดับ

คุณส่งคําขอหลายรายการใน API ได้โดยการเรียกใช้custombatch เมธอดที่เหมาะสม ดังนี้

ทรัพยากรและเมธอดการประมวลผลเป็นกลุ่มที่กำหนดเองที่เกี่ยวข้อง
Accounts accounts.custombatch
Accountstatuses accountstatuses.custombatch
Accounttax accounttax.custombatch
Datafeeds datafeeds.custombatch
Datafeedstatuses datafeedstatuses.custombatch
Localinventory localinventory.custombatch
Liasettings liasettings.custombatch
Pos pos.custombatch
Products products.custombatch
Productstatuses productstatuses.custombatch
Shippingsettings shippingsettings.custombatch

จำกัดสูงสุด

เราขอแนะนำให้จำกัดขนาดของคำขอ custombatch ไว้ที่ไม่เกิน 1,000 รายการ เพื่อหลีกเลี่ยงข้อผิดพลาดเมื่ออัปโหลดหลายรายการพร้อมกัน จำนวนสูงสุดต่อไปนี้ใช้กับคำขอ custombatch

  • รายการ 50,000 รายการต่อคำขอ custombatch
  • ขนาดการโอน 32 MB

การเรียกใช้ที่เกินขีดจํากัดสูงสุดจะทําให้เกิดrequest_too_largeข้อผิดพลาดต่อไปนี้

  • "Too many requests in a batch."
  • "Request payload size exceeds the limit: %d bytes."