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