पाठ 12 / 25
API को वर्ज़निंग की ज़रूरत क्यों
जानें कि APIs को versioning क्यों चाहिए, कौन-से बदलाव breaking हैं और मौजूदा clients को नुकसान पहुँचाए बिना API कैसे विकसित करें।
आप क्लाइंट को नियंत्रित नहीं करते
किसी आंतरिक लाइब्रेरी के विपरीत, आप हर उपभोक्ता को एक साथ अपग्रेड करने पर मजबूर नहीं कर सकते — मोबाइल ऐप महीनों पुराने वर्ज़न पर रहते हैं, थर्ड पार्टी एक बार इंटीग्रेट करके भूल जाते हैं। साझा एंडपॉइंट में ब्रेकिंग बदलाव इन सभी को एक साथ तोड़ देता है।
एडिटिव बनाम ब्रेकिंग
नया वैकल्पिक फ़ील्ड या एंडपॉइंट जोड़ना आमतौर पर वर्ज़न बढ़ाए बिना सुरक्षित है। फ़ील्ड का नाम बदलना/हटाना, टाइप बदलना, या स्टेटस कोड बदलना ब्रेकिंग है — इसे प्रबंधित करने के लिए ही वर्ज़निंग है।
पहले दिन से वर्ज़न करें
v2 की कोई योजना न होने पर भी v1 प्रीफ़िक्स रखने में अभी कुछ खर्च नहीं होता और बाद में जब असली क्लाइंट आप पर निर्भर हों, तब यह दर्दनाक माइग्रेशन बचाता है।