SDK क्या है? Software Development Kit आसान भाषा में

SDK (सॉफ़्टवेयर डेवलपमेंट किट) एक तैयार टूलकिट है, जो कोई कंपनी डेवलपर्स को देती है ताकि वे सब कुछ शुरू से बनाए बिना उसकी सेवा या प्लेटफ़ॉर्म इस्तेमाल कर सकें। इसमें आमतौर पर किसी खास प्रोग्रामिंग भाषा के लिए कोड लाइब्रेरी, दस्तावेज़ और उदाहरण होते हैं, और कभी-कभी टेस्टिंग के लिए अतिरिक्त टूल भी। जब आपका ऐप “Stripe SDK इस्तेमाल करता है”, तो इसका मतलब है कि आपका कोड Stripe के API पर हर अनुरोध हाथ से लिखने के बजाय Stripe के पहले से बने फ़ंक्शन कॉल करता है।

AI से ऐप बनाते समय SDK क्यों मायने रखते हैं

जब आप किसी AI बिल्डर से पेमेंट, AI चैट, मैप या ईमेल जोड़ने को कहते हैं, तो वह आमतौर पर उस प्रदाता का SDK इंस्टॉल करता है और उसे कॉल करने वाली कुछ लाइनें लिखता है। SDK क्या है, यह जानने से आप यह कर पाते हैं:

• समझना कि आपके प्रोजेक्ट में क्या जुड़ रहा है। SDK एक डिपेंडेंसी है, यानी बाहर का ऐसा कोड जिस पर आपका ऐप अब निर्भर है।
• ज़रूरी सेटअप पहचानना। लगभग हर SDK को एक API key चाहिए, और कई के अलग “सर्वर” और “ब्राउज़र” वर्ज़न होते हैं, जिनके नियम अलग होते हैं कि कौन सी key सुरक्षित रूप से इस्तेमाल हो सकती है।
• सही चीज़ माँगना। “सर्वर पर आधिकारिक Stripe SDK इस्तेमाल करो” “Stripe जोड़ो” कहने से कहीं ज़्यादा साफ़ निर्देश है।
• एरर पढ़ना। AI से बने ऐप्स की कई एरर इसलिए आती हैं कि SDK गलत तरीके से सेट हुआ है, पुराना है, या गलत जगह इस्तेमाल हुआ है।

रोज़मर्रा की एक मिसाल

कल्पना कीजिए कि आप शेल्फ़ लगाना चाहते हैं।

• API इमारत के नियम हैं: किन दीवारों में स्क्रू लग सकते हैं, वे कितना वज़न उठाती हैं, पाइप कहाँ हैं। आप चाहें तो सिर्फ़ इन नियमों के सहारे काम कर सकते हैं, सब कुछ खुद नापकर ड्रिल करके।
• SDK उसी कंपनी का फ़्लैट-पैक शेल्फ़ किट है जिसने दीवारें बनाई हैं: पहले से कटे हुए पुर्ज़े, सही स्क्रू, उनकी दीवारों में ठीक बैठने वाला ब्रैकेट, और एक निर्देश पुस्तिका।

शेल्फ़ कहाँ लगेगी और उस पर क्या रखा जाएगा, यह फ़ैसला आप ही करते हैं। किट बस लकड़ी काटने और स्क्रू के साइज़ का अंदाज़ा लगाने से बचाती है, और इस बात की संभावना भी कम करती है कि पानी के पाइप में छेद हो जाए।

SDK बनाम API बनाम लाइब्रेरी बनाम फ़्रेमवर्क

ये शब्द आपस में मिलते-जुलते हैं, जिससे कई लोग उलझ जाते हैं:

SDK में आमतौर पर एक लाइब्रेरी होती है, और वह लाइब्रेरी आमतौर पर एक API को कॉल करती है। वेब सेवाओं के लिए “SDK” और “client library” अक्सर एक ही अर्थ में इस्तेमाल होते हैं।

कुछ SDK वेब सेवाओं से जुड़े ही नहीं होते। Apple और Google iOS और Android ऐप बनाने के लिए SDK प्रकाशित करते हैं, जिनमें कंपाइलर, सिम्युलेटर और प्लेटफ़ॉर्म कोड शामिल हैं। विचार वही है: उनके प्लेटफ़ॉर्म के लिए बनाने की ज़रूरत की हर चीज़ एक ही किट में।

SDK आपके लिए क्या करता है

यही काम, यानी किसी पेमेंट प्रदाता पर एक ग्राहक बनाना, दो तरीकों से करके देखते हैं।

बिना SDK के, आपके कोड को HTTP अनुरोध खुद बनाना पड़ता है: URL सेट करना, सही हेडर में सीक्रेट key जोड़ना, डेटा को वैसे फ़ॉर्मेट करना जैसे API उम्मीद करता है, भेजना, स्टेटस कोड जाँचना, जवाब पार्स करना, और नेटवर्क में गड़बड़ी हो तो दोबारा कोशिश संभालना।

SDK के साथ, यह लगभग एक लाइन है:

const customer = await stripe.customers.create({ email: "lena@example.com" });

उस एक लाइन के पीछे SDK ये चीज़ें संभालता है:

• प्रमाणीकरण (Authentication): हर अनुरोध के साथ आपकी key सही तरीके से जोड़ना
• डेटा फ़ॉर्मेटिंग: आपके डेटा को वैसा बनाना जैसा API चाहता है, और जवाब को वापस ऑब्जेक्ट में बदलना
• एरर: स्टेटस कोड को साफ़ एरर प्रकारों में बदलना जिन्हें आपका कोड पकड़ सके
• दोबारा कोशिश (Retries): अस्थायी कारणों से अनुरोध विफल होने पर सुरक्षित रूप से फिर से कोशिश करना (कई आधिकारिक SDK ऐसा करते हैं)
• टाइप्स: TypeScript में अपने एडिटर को बताना कि कौन से फ़ील्ड मौजूद हैं, ताकि कोड चलाने से पहले ही गलतियाँ दिख जाएँ

एक उदाहरण: सपोर्ट ऐप में AI जवाब जोड़ना

आप AI बिल्डर से कहते हैं: “जब कोई ग्राहक सपोर्ट टिकट भेजे, तो एक AI मॉडल से सुझाया हुआ जवाब बनाओ।”

1. AI मॉडल प्रदाता का आधिकारिक SDK आपके प्रोजेक्ट में पैकेज के रूप में इंस्टॉल करता है (JavaScript प्रोजेक्ट में, npm रजिस्ट्री से)।
2. आप प्रदाता की API key को प्रोजेक्ट सीक्रेट के रूप में जोड़ते हैं। SDK उसे सर्वर पर एक एनवायरनमेंट वेरिएबल से पढ़ता है।
3. AI एक सर्वर रूट लिखता है जो टिकट का टेक्स्ट और एक छोटा निर्देश देकर SDK को कॉल करता है, और सुझाया गया जवाब डेटाबेस में सहेजता है।
4. ब्राउज़र कभी key नहीं देखता; वह सिर्फ़ आपके अपने सर्वर रूट को कॉल करता है।

अगर प्रदाता बाद में अपना API बदलता है, तो आमतौर पर वह नया SDK वर्ज़न जारी करता है। पैकेज अपडेट करना, और ब्रेकिंग बदलावों के लिए रिलीज़ नोट्स देखना, अक्सर बस इतना ही काफ़ी होता है।

मुख्य शब्द

आम गलतफ़हमियाँ

• “SDK और API एक ही चीज़ हैं।” API सेवा का इंटरफ़ेस है; SDK उसके ऊपर सुविधा की एक परत है। ज़्यादातर वेब API आप बिना SDK के भी कॉल कर सकते हैं, बस ज़्यादा काम लगता है।
• “अगर SDK इंस्टॉल है, तो इंटीग्रेशन पूरा हो गया।” आपको अब भी प्रदाता के साथ खाते, सही key और ऐसा कोड चाहिए जो विफलता के समय को संभाले।
• “सही नाम वाला कोई भी पैकेज आधिकारिक ही है।” हमलावर कभी-कभी मिलते-जुलते नाम वाले पैकेज प्रकाशित कर देते हैं। सही पैकेज नाम के लिए प्रदाता के दस्तावेज़ देखें।
• “ब्राउज़र SDK मेरी सीक्रेट key इस्तेमाल कर सकता है।” कभी नहीं। ब्राउज़र कोड में जो भी है, वह विज़िटर्स को दिखता है। सीक्रेट key सिर्फ़ सर्वर-साइड कोड में रहनी चाहिए, देखें API keys को सुरक्षित कैसे रखें।
• “SDK को कभी अपडेट करने की ज़रूरत नहीं होती।” पुराने वर्ज़न को फ़िक्स मिलना बंद हो जाता है, और जब प्रदाता पुराने API वर्ज़न बंद करते हैं तो वे आखिरकार काम करना छोड़ देते हैं।

अपने AI बिल्डर से क्या पूछें

• “प्रदाता का आधिकारिक SDK इस्तेमाल करो, तीसरे पक्ष का रैपर नहीं। इंस्टॉल किया गया सटीक पैकेज नाम और वर्ज़न बताओ।”
• “SDK सिर्फ़ सर्वर पर इस्तेमाल करो, और key एक एनवायरनमेंट वेरिएबल से पढ़ो।”
• “इस SDK का कौन सा हिस्सा ब्राउज़र में चलता है, और वह कौन सी key इस्तेमाल करता है?”
• “अगर SDK कॉल विफल या टाइम आउट हो जाए तो क्या होता है? यूज़र को साफ़ संदेश दिखाओ और एरर लॉग करो।”
• “इस ऐप की हर SDK और पैकेज डिपेंडेंसी की सूची दो, और बताओ हर एक किस काम आता है।”
• “जाँचो कि हमारे कोई SDK पुराने हैं या उनमें कोई ज्ञात सुरक्षा समस्या है।”

Mythex में SDK

Mythex एजेंट आपके प्रोजेक्ट सैंडबॉक्स में, आपके स्टैक के सामान्य पैकेज मैनेजर से, प्रदाताओं के SDK सहित पैकेज इंस्टॉल कर सकता है। बस पैकेज और जिस सुविधा के लिए चाहिए उसका नाम बताएँ। देखें npm पैकेज इस्तेमाल करना। Mythex आपके ऐप के लिए पहले से बने इंटीग्रेशन की कोई सूची नहीं देता: आप प्रदाता की key को प्रोजेक्ट सीक्रेट के रूप में सहेजते हैं और एजेंट से कहते हैं कि सेवा को सर्वर साइड से कॉल करे, जैसा Integrate any API में बताया गया है।

SDK के नीचे की परत के लिए पढ़ें API क्या है। SDK पर आधारित दो आम फ़ीचर के लिए देखें अपने ऐप में पेमेंट कैसे जोड़ें और LLM APIs कैसे इस्तेमाल करें।

सवाल