الطلبات المجمّعة

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