बैच अनुरोध

custombatch एक सामान्य तरीका है. इसकी मदद से, कई एपीआई कॉल को एक एचटीटीपी अनुरोध में ग्रुप किया जा सकता है. इन्हें "ऐंट्री" कहा जाता है. हर एंट्री में, सिर्फ़ एक तरीके के कॉल का रेफ़रंस होता है.

कस्टम बैच का इस्तेमाल तब करना सबसे सही होता है, जब:

• आपने अभी-अभी एपीआई का इस्तेमाल शुरू किया है और आपको बहुत सारा प्रॉडक्ट डेटा अपलोड करना है.
• आपको कई अपडेट और मिटाए गए डेटा को भेजकर, स्थानीय डेटा को सर्वर के साथ सिंक करना होगा.

एक साथ कई अनुरोध करना

बैच अनुरोध भेजने का तरीका, एक साथ कई एपीआई कॉल भेजने के तरीके जैसा ही होता है. ध्यान दें कि इस बात की कोई गारंटी नहीं है कि अनुरोध में तय की गई एंट्री का क्रम, उसी क्रम में होगा जिसमें उन्हें लागू किया जाता है. हमारा सुझाव है कि एक ही बैच अनुरोध में, एक-दूसरे पर निर्भर कॉल का इस्तेमाल न करें. जैसे, एक ही शिपमेंट को बनाना और अपडेट करना.

इसी तरह, बैच किए गए अनुरोधों के लिए मिले जवाब, अनुरोध की एंट्री के क्रम से अलग क्रम में दिखाए जा सकते हैं. BatchId का इस्तेमाल, अनुरोधों और जवाबों को आपस में जोड़ने के लिए किया जा सकता है. ऐसा इसलिए, क्योंकि जवाब क्रम से नहीं मिलते हैं.

एपीआई में अनुरोधों को बैच किया जा सकता है. इसके लिए, सही custombatch तरीके का इस्तेमाल करें:

सीमाएं

बड़ी संख्या में बैच अपलोड करते समय गड़बड़ियों से बचने के लिए, हमारा सुझाव है कि custombatch अनुरोधों का साइज़ सीमित रखें. इनमें ज़्यादा से ज़्यादा 1,000 एंट्री होनी चाहिए. custombatch अनुरोधों के लिए, ये सीमाएं लागू होती हैं:

• हर custombatch अनुरोध में 50,000 एंट्री
• ट्रांसफ़र साइज़ 32 एमबी

ज़्यादा से ज़्यादा कॉल करने पर, ये request_too_large गड़बड़ियां होती हैं:

• "Too many requests in a batch."
• "Request payload size exceeds the limit: %d bytes."