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