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."