custombatch היא שיטה נפוצה שמאפשרת לקבץ מספר קריאות ל-API, שנקראות 'רשומות', לבקשת HTTP אחת. כל רשומה מפנה רק להפעלת method אחת.
אצווה בהתאמה אישית היא אפשרות טובה במקרים הבאים:
- רק התחלתם להשתמש ב-API ויש לכם הרבה נתוני מוצרים להעלות.
- צריך לסנכרן נתונים מקומיים עם השרת על ידי שליחת הרבה עדכונים ומחיקות.
יצירת בקשות באצווה
שליחת בקשות באצווה דומה לשליחת קריאות ל-API במקביל. שימו לב שאין ערובה לכך שסדר הרשומות שמוגדר בבקשה יהיה לפי הסדר שבו הן יבוצעו. מומלץ לא להשתמש בקריאות תלויות-נפרדות בבקשה באצווה אחת (למשל, יצירה ועדכון של אותו משלוח).
באופן דומה, התגובות שמתקבלות לבקשות באצווה עשויות להיות מוחזרות בסדר שונה מזה של הבקשות רשומות. אפשר להשתמש ב-BatchId כדי להתאים בין בקשות לבין תשובות, כי יכול להיות שהתשובות יוחזרו מחוץ לרצף.
אפשר לקבץ בקשות ב-API על ידי קריאה ל-method המתאים 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 - גודל העברה של 32Mb
כשקריאות חורגות מהמספר המקסימלי המותר, מופיעות שגיאות request_too_large הבאות:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."