custombatch یک روش رایج است که به شما امکان می دهد چندین تماس API را که به عنوان "ورودی" شناخته می شوند در یک درخواست HTTP گروه بندی کنید. هر ورودی فقط به یک فراخوانی متد اشاره دارد.
دسته سفارشی انتخاب خوبی است زمانی که:
- شما به تازگی استفاده از API را شروع کرده اید و داده های محصول زیادی برای آپلود دارید.
- شما باید داده های محلی را با ارسال تعداد زیادی به روز رسانی و حذف با سرور همگام سازی کنید.
درخواست های دسته ای ارائه دهید
ارسال درخواست های دسته ای مشابه ارسال تماس های API به صورت موازی است. توجه داشته باشید که هیچ تضمینی وجود ندارد که ترتیب ورودی های تعریف شده در درخواست به ترتیبی باشد که اجرا می شوند. توصیه می‌کنیم از تماس‌های وابسته به هم در یک درخواست دسته‌ای استفاده نکنید (مانند ایجاد و به‌روزرسانی یک محموله).
به طور مشابه، پاسخ‌های دریافت شده برای درخواست‌های دسته‌ای ممکن است به ترتیبی متفاوت از ورودی‌های درخواست بازگردانده شوند. BatchId می توان برای ارتباط بین درخواست ها و پاسخ ها استفاده کرد زیرا ممکن است پاسخ ها خارج از ترتیب بازگردانده شوند.
می‌توانید با فراخوانی روش custombatch مناسب، درخواست‌های دسته‌ای را در API انجام دهید:
| منابع و روش های دسته ای سفارشی مربوط به آنها | |
|---|---|
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 را به حداکثر 1000 ورودی محدود کنید. حداکثرهای زیر برای درخواست های custombatch اعمال می شود:
- 50000 ورودی در هر درخواست
custombatch - حجم انتقال 32 مگابایت
تماس هایی که بیش از حداکثر مجاز هستند منجر به خطاهای request_too_large زیر می شوند:
-
"Too many requests in a batch." -
"Request payload size exceeds the limit: %d bytes."