एक एपीआई (एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस) नियमों और परिभाषाओं का एक सेट है जो एक सॉफ्टवेयर एप्लिकेशन को दूसरे के साथ संचार करने की अनुमति देता है। यह एक मध्यस्थ के रूप में कार्य करता है, जो विभिन्न सॉफ़्टवेयर सिस्टमों को उनके द्वारा किए जाने वाले अनुरोधों के प्रकार, उन अनुरोधों को कैसे करना है, डेटा प्रारूप और सिस्टम को कैसे प्रतिक्रिया देनी चाहिए, को परिभाषित करके एक-दूसरे के साथ बातचीत करने में सक्षम बनाता है।

एपीआई में प्रमुख अवधारणाएँ

1. अंतबिंदु:

   • ये विशिष्ट यूआरएल हैं जिन्हें एपीआई बाहरी अनुप्रयोगों को इसके साथ बातचीत करने की अनुमति देने के लिए उजागर करता है। उदाहरण के लिए, यदि आप मौसम एपीआई से डेटा प्राप्त करना चाहते हैं, तो आपको https://api.weather.com/v1/forecast जैसे विशिष्ट समापन बिंदु पर एक अनुरोध भेजना होगा।

2. अनुरोध और प्रतिक्रियाएं:

   • अनुरोध: एप्लिकेशन एपीआई एंडपॉइंट पर एक अनुरोध भेजता है, यह निर्दिष्ट करते हुए कि वह कौन सा डेटा या कार्रवाई चाहता है।
   • प्रतिक्रिया: एपीआई एक प्रतिक्रिया भेजता है, जिसमें डेटा (अक्सर JSON या XML प्रारूप में), एक स्थिति कोड और एक संदेश शामिल हो सकता है।
     • उदाहरण स्थिति कोड:
     • 200 ठीक: अनुरोध सफल रहा।
     • 404 नहीं मिला: समापन बिंदु मौजूद नहीं है।
     • 500 आंतरिक सर्वर त्रुटि: सर्वर-साइड समस्या थी।

3. HTTP तरीके:
   एपीआई आमतौर पर अनुरोधों के लिए विशिष्ट HTTP तरीकों का उपयोग करते हैं, जैसे:

   • प्राप्त करें: डेटा पुनर्प्राप्त करें।
   • पोस्ट: संसाधन बनाने या अपडेट करने के लिए डेटा सबमिट करें।
   • PUT: किसी संसाधन को अपडेट करें या बदलें।
   • हटाएं: एक संसाधन हटाएं।

4. एपीआई कुंजी और प्रमाणीकरण:
   कुछ एपीआई के लिए उपयोगकर्ताओं को अनुरोध करने से पहले स्वयं को प्रमाणित करने की आवश्यकता होती है। यह इसके माध्यम से किया जाता है:

   • एपीआई कुंजी: किसी उपयोगकर्ता या एप्लिकेशन को प्रमाणित करने के लिए उपयोग किया जाने वाला एक विशिष्ट पहचानकर्ता।
   • OAuth: एक अधिक उन्नत प्रोटोकॉल जो उपयोगकर्ताओं को अपनी साख साझा किए बिना तृतीय-पक्ष सेवाओं के माध्यम से प्रमाणित करने की अनुमति देता है।

5. दर सीमित:
   कई एपीआई एक निश्चित समय सीमा के भीतर किसी एप्लिकेशन द्वारा किए जा सकने वाले अनुरोधों की संख्या को सीमित कर देते हैं। यह सुनिश्चित करना है कि सर्वर एक ही स्रोत से बहुत अधिक अनुरोधों से अभिभूत न हो।

6. रेस्टफुल एपीआई:
   रिप्रेजेंटेशनल स्टेट ट्रांसफर (आरईएसटी) एपीआई के निर्माण के लिए एक लोकप्रिय आर्किटेक्चर है। RESTful API स्टेटलेस हैं और मानक HTTP विधियों का उपयोग करते हैं। REST के प्रमुख सिद्धांतों में शामिल हैं:

   • स्टेटलेसनेस: क्लाइंट से सर्वर तक प्रत्येक अनुरोध में अनुरोध को समझने और संसाधित करने के लिए आवश्यक सभी जानकारी शामिल होनी चाहिए।
   • यूनिफ़ॉर्म इंटरफ़ेस: संसाधनों तक एक समान यूआरएल संरचना के माध्यम से पहुंच होनी चाहिए।
   • संसाधन प्रतिनिधित्व: संसाधनों को आमतौर पर JSON या XML जैसे प्रारूपों का उपयोग करके दर्शाया जाता है।

7. SOAP API:
   SOAP (सिंपल ऑब्जेक्ट एक्सेस प्रोटोकॉल) एपीआई बनाने के लिए एक और प्रोटोकॉल है, जो अधिक संरचित है और इसमें एक मानकीकृत मैसेजिंग सिस्टम शामिल है। यह उन अनुप्रयोगों के लिए अधिक सुरक्षित और आदर्श है जहां सुरक्षा एक उच्च प्राथमिकता है (जैसे बैंकिंग)।

एपीआई इंटरेक्शन का उदाहरण

कल्पना करें कि आपके पास एक मौसम ऐप है, और आप न्यूयॉर्क शहर का वर्तमान मौसम जानना चाहते हैं। यहां बताया गया है कि एपीआई इंटरैक्शन कैसा दिखेगा:

1. आपका ऐप एपीआई एंडपॉइंट पर एक GET अनुरोध भेजता है:

   https://api.weather.com/v1/city/newyork

1. सर्वर अनुरोध संसाधित करता है और JSON प्रारूप में एक प्रतिक्रिया वापस भेजता है:

   {
     "city": "New York",
     "temperature": "15°C",
     "description": "Clear sky"
   }

आपका ऐप अब उपयोगकर्ताओं को यह जानकारी प्रदर्शित कर सकता है।

एपीआई के प्रकार

1. वेब एपीआई: ये सबसे आम हैं, जिनका उपयोग वेब पर दूरस्थ सर्वर, जैसे आरईएसटी या एसओएपी एपीआई के साथ बातचीत करने के लिए किया जाता है।
2. ऑपरेटिंग सिस्टम एपीआई: एपीआई जो सॉफ्टवेयर को ऑपरेटिंग सिस्टम के साथ इंटरैक्ट करने की अनुमति देते हैं।
3. डेटाबेस एपीआई: ये डेटाबेस के साथ इंटरेक्शन सक्षम करते हैं, जिससे एप्लिकेशन को डेटाबेस में संग्रहीत डेटा को पढ़ने या संशोधित करने की अनुमति मिलती है।
4. लाइब्रेरी या फ्रेमवर्क एपीआई: ये लाइब्रेरी या फ्रेमवर्क द्वारा प्रदान की जाने वाली एपीआई हैं, जो डेवलपर्स को व्हील को फिर से तैयार किए बिना कोड का पुन: उपयोग करने की अनुमति देती हैं।

आधुनिक सॉफ्टवेयर विकास में एपीआई महत्वपूर्ण हैं, जो विभिन्न सेवाओं और अनुप्रयोगों को एक साथ निर्बाध रूप से काम करने की अनुमति देते हैं। इनका उपयोग वेब विकास, मोबाइल ऐप्स, IoT उपकरणों और बहुत कुछ में किया जाता है।