# API को वर्ज़निंग की ज़रूरत क्यों — रेस्ट एपीआई डिज़ाइन

Source: https://www.geekswithgeeks.com/hi/restapi/api-versioning-why

> पहले से उपयोग कर रहे क्लाइंट को तोड़े बिना API को विकसित करना।

## आप क्लाइंट को नियंत्रित नहीं करते

किसी आंतरिक लाइब्रेरी के विपरीत, आप हर उपभोक्ता को एक साथ अपग्रेड करने पर मजबूर नहीं कर सकते — मोबाइल ऐप महीनों पुराने वर्ज़न पर रहते हैं, थर्ड पार्टी एक बार इंटीग्रेट करके भूल जाते हैं। साझा एंडपॉइंट में ब्रेकिंग बदलाव इन सभी को एक साथ तोड़ देता है।

## एडिटिव बनाम ब्रेकिंग

नया वैकल्पिक फ़ील्ड या एंडपॉइंट जोड़ना आमतौर पर वर्ज़न बढ़ाए बिना सुरक्षित है। फ़ील्ड का नाम बदलना/हटाना, टाइप बदलना, या स्टेटस कोड बदलना **ब्रेकिंग** है — इसे प्रबंधित करने के लिए ही वर्ज़निंग है।

## पहले दिन से वर्ज़न करें

`v2` की कोई योजना न होने पर भी `v1` प्रीफ़िक्स रखने में अभी कुछ खर्च नहीं होता और बाद में जब असली क्लाइंट आप पर निर्भर हों, तब यह दर्दनाक माइग्रेशन बचाता है।
