एक बैच एंडपॉइंट एक ही अनुरोध में कई आइटम (बनाने के लिए रिकॉर्ड, हटाने के लिए आईडी) स्वीकार करता है, जिससे प्रत्येक आइटम के लिए एक राउंड ट्रिप बच जाती है। चूंकि कुछ आइटम सफल हो सकते हैं जबकि अन्य असफल, इसलिए प्रतिक्रिया प्रत्येक आइटम की अलग-अलग रिपोर्ट करती है, और 207 मल्टी-स्टेटस ठीक इसी स्थिति के लिए स्टेटस कोड है: "look inside, the outcomes differ" ।
प्रतिक्रिया के मुख्य भाग में प्रत्येक आइटम की स्थिति सूचीबद्ध होती है, आमतौर पर अनुरोध के क्रम में या क्लाइंट द्वारा प्रदान की गई आईडी के आधार पर। डिज़ाइन में एटॉमिकिटी के आधार पर भिन्नता होती है: कुछ बैच पूरी तरह से या बिल्कुल नहीं वाले होते हैं और यदि कोई आइटम अमान्य होता है तो एक ही 4xx त्रुटि देते हैं; अन्य बैच जितना संभव हो उतना कमिट करते हैं और शेष की रिपोर्ट करते हैं। API को यह दस्तावेज़ित करना होगा कि कौन सा बैच कौन सा है।
बैच में 2xx का मतलब है कि सब कुछ ठीक से काम कर गया। 207 सफलता श्रेणी में आता है, और जो क्लाइंट केवल response.ok की जाँच करता है, वह सफलता की रिपोर्ट करेगा जबकि उसके आधे रिकॉर्ड अस्वीकृत हो गए होंगे। बैच क्लाइंट को प्रत्येक आइटम के परिणामों को दोहराना होगा।
POST /friends/v1/characters/bulk प्रत्येक आइटम को अलग-अलग मान्य करता है और कुछ के विफल होने पर 207 उत्तर देता है, और POST /friends/v1/characters/bulk-delete आंशिक सफलता की रिपोर्ट उसी तरह करता है; इसे देखने के लिए अच्छे आइटमों के बीच एक खराब आइटम भेजें।
सभी शब्द · परीक्षण तकनीकें · सभी 39 मॉक REST API
आखरी अपडेट