किसी बड़े बदलाव (जैसे किसी फ़ील्ड का नाम बदलना, किसी एंडपॉइंट को हटाना, या त्रुटि के स्वरूप में परिवर्तन) से पुराने व्यवहार पर आधारित सभी क्लाइंट विफल हो जाएंगे। वर्ज़निंग से प्रदाता नए व्यवहार को एक नए वर्ज़न के रूप में जारी कर सकता है, जबकि पुराना वर्ज़न काम करता रहता है, और क्लाइंट को माइग्रेट करने के लिए एक निश्चित समय मिल जाता है।
संस्करण आमतौर पर URL पथ ( /v1 /, /v2 /) में, कभी-कभी हेडर में या Accept मीडिया प्रकार में, और कभी-कभी तिथि के रूप में दर्शाया जाता है। गैर-परिवर्तनकारी बदलाव — नए वैकल्पिक फ़ील्ड, नए एंडपॉइंट — संस्करण के भीतर ही शामिल किए जाते हैं। जब कोई पुराना संस्करण बंद किया जाता है, तो प्रदाता इसकी सूचना पहले से ही दे देता है, अक्सर अपने रिस्पॉन्स में Deprecation और Sunset हेडर का उपयोग करके।
किसी फ़ील्ड को जोड़ना हमेशा सुरक्षित नहीं होता। यह उन क्लाइंट्स के लिए है जो अज्ञात फ़ील्ड्स को अनदेखा करते हैं, और सख्त डीसीरियलाइज़र या स्नैपशॉट परीक्षणों के साथ उन्हें बाधित करता है। "breaking" क्या मानी जाती है, यह इस बात पर निर्भर करता है कि क्लाइंट वास्तव में क्या करते हैं, इसीलिए प्रदाता अपने संगतता नियम प्रकाशित करते हैं।
फ्रेंड्स एपीआई दोनों संस्करणों को चलाता है: GET /friends/v1/characters अप्रचलित के रूप में चिह्नित किया गया है, और GET /friends/v2/characters नौकरी का नाम बदलकर व्यवसाय कर देता है और सूची को पुनः व्यवस्थित करता है; GET /friends/version समर्थित जानकारी सूचीबद्ध करता है।
सभी शब्द · परीक्षण तकनीकें · सभी 39 मॉक REST API
आखरी अपडेट