custombatch
هي طريقة شائعة تتيح لك تجميع عدة طلبات من واجهة برمجة التطبيقات،
والمعروفة باسم "الإدخالات" في طلب HTTP واحد. يشير كل إدخال إلى استدعاء
طريقة واحدة فقط.
تكون الدفعة المخصصة خيارًا جيدًا في الحالات التالية:
- لقد بدأت للتو في استخدام واجهة برمجة التطبيقات ولديك الكثير من بيانات المنتجات لتحميلها.
- وتحتاج إلى مزامنة البيانات المحلية مع الخادم عن طريق إرسال الكثير من التحديثات والحذف.
تقديم طلبات دُفعة
يشبه إرسال الطلبات المجمّعة إرسال طلبات البيانات من واجهة برمجة التطبيقات في الوقت نفسه. يُرجى العلم أنّه ليس هناك ما يضمن أن ترتيب الإدخالات المحدّدة في الطلب سيكون بالترتيب الذي تم تنفيذه فيه. ننصح بعدم استخدام طلبات مترابطة في طلب مجمّع واحد (مثل إنشاء الشحنة نفسها وتعديلها).
وبالمثل، قد يتم عرض الردود التي تم استلامها للطلبات المجمّعة بترتيب مختلف عن ترتيب إدخالات الطلب. يمكن استخدام BatchId
لربط الطلبات والردود، لأنّه قد يتم عرض الاستجابات خارج التسلسل.
يمكنك تجميع الطلبات في واجهة برمجة التطبيقات من خلال استدعاء طريقة 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 |
الحدود المسموح بها
لتجنّب حدوث أخطاء عند تحميل دفعات كبيرة، ننصح بإدراج 1,000 إدخال كحدّ أقصى في طلبات custombatch
. تنطبق الحدود القصوى التالية
على طلبات custombatch
:
- 50,000 إدخال لكل طلب
custombatch
- حجم النقل 32 ميغابايت
تؤدي المكالمات التي تتجاوز الحد الأقصى إلى حدوث أخطاء request_too_large
التالية:
"Too many requests in a batch."
"Request payload size exceeds the limit: %d bytes."