एपीआई

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

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

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

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

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

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

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

विल्क्स एंड व्हीलर की 1951 की पुस्तक द प्रिपरेशन ऑफ प्रोग्राम्स फॉर ए इलेक्ट्रॉनिक डिजिटल कंप्यूटर में पहला प्रकाशित एपीआई विनिर्देश शामिल है। जोशुआ बलोच का मानना ​​है कि विल्क्स और व्हीलर ने हाल ही में एपीआई का आविष्कार किया था क्योंकि यह एक ऐसी अवधारणा है जो आविष्कार की तुलना में खोजी गई है।



1960 और 1970 के दशक
टर्म एप्लिकेशन प्रोग्राम इंटरफ़ेस (बिना -इंग प्रत्यय के) पहली बार 1968 में AFIPS सम्मेलन में प्रस्तुत रिमोट कंप्यूटर ग्राफिक्स के लिए डेटा स्ट्रक्चर्स एंड टेक्निक्स नामक एक पेपर में दर्ज किया गया था। इस पत्र के लेखक इस शब्द का उपयोग एक एप्लिकेशन की बातचीत का वर्णन करने के लिए करते हैं - इस मामले में एक ग्राफिक्स प्रोग्राम - बाकी कंप्यूटर सिस्टम के साथ। एक सुसंगत एप्लिकेशन इंटरफ़ेस (फोरट्रान सबरूटीन कॉल से मिलकर) का उद्देश्य प्रोग्रामर को ग्राफिक्स डिस्प्ले डिवाइस की आइडियोसिंक्रसी से निपटने से मुक्त करना था, और कंप्यूटर या डिस्प्ले को बदलने पर हार्डवेयर स्वतंत्रता प्रदान करना था। यह शब्द डेटाबेस के क्षेत्र में क्रिस्टोफर जे. डेट|सी द्वारा पेश किया गया था। जे दिनांक 1974 में द रिलेशनल डेटाबेस एंड नेटवर्क मॉडल अप्रोचेज: कंपेरिजन ऑफ द एप्लीकेशन प्रोग्रामिंग इंटरफेस नामक पेपर में। एक एपीआई ANSI-SPARC आर्किटेक्चर| डेटाबेस प्रबंधन प्रणालियों के लिए ANSI/SPARC फ्रेमवर्क का एक हिस्सा बन गया। इस ढांचे ने एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस को अन्य इंटरफेस, जैसे कि क्वेरी इंटरफ़ेस से अलग से व्यवहार किया। 1970 के दशक में डेटाबेस पेशेवरों ने देखा कि इन विभिन्न इंटरफेस को जोड़ा जा सकता है; पर्याप्त रूप से समृद्ध एप्लिकेशन इंटरफ़ेस अन्य इंटरफेस का भी समर्थन कर सकता है। इस अवलोकन ने एपीआई का नेतृत्व किया जो सभी प्रकार की प्रोग्रामिंग का समर्थन करता था, न कि केवल एप्लिकेशन प्रोग्रामिंग का।

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

2000 के दशक
2000 में यूसी इरविन में रॉय फील्डिंग के निबंध आर्किटेक्चरल स्टाइल्स एंड द डिजाइन ऑफ नेटवर्क-बेस्ड सॉफ्टवेयर आर्किटेक्चर ने रिप्रेजेंटेशनल स्टेट ट्रांसफर (आरईएसटी) को रेखांकित किया और एक नेटवर्क-आधारित एप्लिकेशन प्रोग्रामिंग इंटरफेस के विचार का वर्णन किया, जो फील्डिंग पारंपरिक लाइब्रेरी-आधारित एपीआई के विपरीत है। XML और JSON वेब APIs ने 2000 में व्यापक व्यावसायिक स्वीकृति देखी और 2022 तक जारी रही। वेब API अब API शब्द का सबसे सामान्य अर्थ है। 2001 में टिम बर्नर्स-ली द्वारा प्रस्तावित सिमेंटिक वेब में सिमेंटिक एपीआई शामिल थे जो एपीआई को एक सॉफ्टवेयर व्यवहार इंटरफेस के बजाय एक खुले नवाचार, वितरित डेटा इंटरफेस के रूप में पुन: पेश करते हैं। मालिकाना सॉफ्टवेयर इंटरफेस और एजेंट खुले वाले की तुलना में अधिक व्यापक हो गए, लेकिन डेटा इंटरफेस के रूप में एपीआई के विचार ने जोर पकड़ लिया। क्योंकि वेब एपीआई व्यापक रूप से ऑनलाइन सभी प्रकार के डेटा का आदान-प्रदान करने के लिए उपयोग किया जाता है, एपीआई एक व्यापक शब्द बन गया है जो इंटरनेट पर अधिकांश संचार का वर्णन करता है। जब इस तरह से उपयोग किया जाता है, तो एपीआई शब्द शब्द संचार प्रोटोकॉल के अर्थ में ओवरलैप होता है।

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

एक ही प्रोग्रामिंग इंटरफेस को साझा करने वाले विभिन्न पुस्तकालयों के रूप में एक एकल एपीआई में कई कार्यान्वयन (या कोई नहीं, सार हो सकता है) हो सकता है।

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

इसके अलावा, नियंत्रण का समग्र कार्यक्रम प्रवाह कॉल करने वाले के नियंत्रण से बाहर हो सकता है और नियंत्रण के व्युत्क्रम या इसी तरह के तंत्र द्वारा ढांचे के हाथों में हो सकता है।

ऑपरेटिंग सिस्टम
एक एपीआई एक एप्लिकेशन और ऑपरेटिंग सिस्टम के बीच इंटरफेस को निर्दिष्ट कर सकता है। POSIX, उदाहरण के लिए, सामान्य API विनिर्देशों का एक सेट प्रदान करता है जिसका उद्देश्य POSIX अनुरूप ऑपरेटिंग सिस्टम के लिए लिखे गए एप्लिकेशन को अन्य POSIX अनुरूप ऑपरेटिंग सिस्टम के लिए कंपाइलर बनाना है।

लिनक्स और बर्कले सॉफ्टवेयर डिस्ट्रीब्यूशन ऑपरेटिंग सिस्टम के उदाहरण हैं जो POSIX API को लागू करते हैं। माइक्रोसॉफ्ट ने पिछड़े-संगत एपीआई के लिए विशेष रूप से अपने विंडोज एपीआई (विन 32) लाइब्रेरी के लिए एक मजबूत प्रतिबद्धता दिखायी है, इसलिए पुराने एप्लिकेशन संगतता मोड नामक निष्पादन योग्य-विशिष्ट सेटिंग का उपयोग करके विंडोज़ के नए संस्करणों पर चल सकते हैं। एक एपीआई एक एप्लिकेशन बाइनरी इंटरफ़ेस (एबीआई) से अलग है जिसमें एपीआई स्रोत कोड आधारित है जबकि एबीआई बाइनरी फ़ाइल आधारित है। उदाहरण के लिए, POSIX API प्रदान करता है जबकि Linux मानक आधार ABI प्रदान करता है।

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

प्रॉक्सी ऑब्जेक्ट के एक संशोधन के परिणामस्वरूप रिमोट ऑब्जेक्ट का एक समान संशोधन भी होगा।

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

एक उदाहरण एक शिपिंग कंपनी एपीआई हो सकती है जिसे शिपिंग सेवाओं को ऑर्डर करने की सुविधा के लिए ईकामर्स-केंद्रित वेबसाइट में जोड़ा जा सकता है और साइट डेवलपर को वेब डेटाबेस में शिपर की दर तालिका में प्रवेश किए बिना स्वचालित रूप से वर्तमान शिपिंग दरों को शामिल किया जा सकता है। जबकि वेब एपीआई ऐतिहासिक रूप से वेब सेवा का पर्यायवाची रहा है, हाल की प्रवृत्ति (तथाकथित वेब 2.0) सिंपल ऑब्जेक्ट एक्सेस प्रोटोकॉल (SOAP) आधारित वेब सेवाओं और सेवा-उन्मुख वास्तुकला (SOA) से अधिक प्रत्यक्ष प्रतिनिधित्व वाली स्थिति की ओर बढ़ रही है। स्थानांतरण (REST) ​​शैली वेब संसाधन और संसाधन-उन्मुख आर्किटेक्चर (ROA)। इस प्रवृत्ति का एक हिस्सा सिमेंटिक वेब मूवमेंट टू रिसोर्स डिस्क्रिप्शन फ्रेमवर्क (RDF) से संबंधित है, जो वेब-आधारित ऑन्कोलॉजी इंजीनियरिंग तकनीकों को बढ़ावा देने के लिए एक अवधारणा है। वेब एपीआई मैशअप (वेब ​​एप्लिकेशन हाइब्रिड) के रूप में ज्ञात नए अनुप्रयोगों में कई एपीआई के संयोजन की अनुमति देता है। सोशल मीडिया स्पेस में, वेब एपीआई ने वेब समुदायों को समुदायों और अनुप्रयोगों के बीच सामग्री और डेटा साझा करने की सुविधा प्रदान करने की अनुमति दी है। इस तरह, एक स्थान पर गतिशील रूप से बनाई गई सामग्री को वेब पर कई स्थानों पर पोस्ट और अपडेट किया जा सकता है। उदाहरण के लिए, ट्विटर का रेस्ट एपीआई डेवलपर्स को कोर ट्विटर डेटा तक पहुंचने की अनुमति देता है और सर्च एपीआई डेवलपर्स को ट्विटर सर्च और ट्रेंड डेटा के साथ इंटरैक्ट करने के तरीके प्रदान करता है।

डिजाइन
एपीआई के डिजाइन का इसके उपयोग पर महत्वपूर्ण प्रभाव पड़ता है। सबसे पहले, प्रोग्रामिंग इंटरफेस का डिजाइन सॉफ्टवेयर आर्किटेक्चर के एक महत्वपूर्ण हिस्से का प्रतिनिधित्व करता है, सॉफ्टवेयर के एक जटिल टुकड़े का संगठन। सूचना छिपाने का सिद्धांत मॉड्यूल के कार्यान्वयन विवरण को छिपाकर मॉड्यूलर प्रोग्रामिंग को सक्षम करने के रूप में प्रोग्रामिंग इंटरफेस की भूमिका का वर्णन करता है ताकि मॉड्यूल के उपयोगकर्ताओं को मॉड्यूल के अंदर की जटिलताओं को समझने की आवश्यकता न हो। पिछले अंतर्निहित सिद्धांत के अलावा, एपीआई की उपयोगिता को मापने के लिए अन्य मेट्रिक्स में कार्यात्मक दक्षता, समग्र शुद्धता और नौसिखियों के लिए सीखने की क्षमता जैसे गुण शामिल हो सकते हैं। एपीआई डिजाइन करने का एक सीधा और आमतौर पर अपनाया जाने वाला तरीका है नीलसन के ह्यूरिस्टिक्स|नील्सन के अनुमानी मूल्यांकन दिशानिर्देशों का पालन करना। फ़ैक्टरी विधि पैटर्न भी उनके पुन: प्रयोज्य प्रकृति के कारण एपीआई को डिजाइन करने में विशिष्ट है। इस प्रकार, एपीआई का डिज़ाइन केवल वे उपकरण प्रदान करने का प्रयास करता है जिनकी उपयोगकर्ता अपेक्षा करता है।

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

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

रिलीज नीतियां
एपीआई अधिक सामान्य तरीकों में से एक है जिसे प्रौद्योगिकी कंपनियां एकीकृत करती हैं। एपीआई प्रदान करने और उपयोग करने वालों को एक व्यावसायिक पारिस्थितिकी तंत्र के सदस्य के रूप में माना जाता है। एपीआई जारी करने की मुख्य नीतियां हैं:
 * निजी : एपीआई केवल कंपनी के आंतरिक उपयोग के लिए है।
 * भागीदार : केवल विशिष्ट व्यावसायिक भागीदार ही एपीआई का उपयोग कर सकते हैं। उदाहरण के लिए, किराए पर लेने वाली कंपनियां जैसे Uber और Lyft, स्वीकृत तृतीय-पक्ष डेवलपर्स को उनके ऐप के भीतर से सीधे सवारी का आदेश देने की अनुमति देती हैं। यह कंपनियों को गुणवत्ता नियंत्रण का अभ्यास करने की अनुमति देता है कि किन ऐप्स की एपीआई तक पहुंच है और उन्हें एक अतिरिक्त राजस्व स्ट्रीम प्रदान करता है।
 * सार्वजनिक : एपीआई जनता के उपयोग के लिए उपलब्ध है। उदाहरण के लिए, Microsoft Windows API को सार्वजनिक करता है, और Apple Inc. अपना API Cocoa (API) जारी करता है ताकि सॉफ्टवेयर को उनके कंप्यूटिंग प्लेटफॉर्म के लिए लिखा जा सके। सभी सार्वजनिक एपीआई आम तौर पर हर किसी के द्वारा सुलभ नहीं होते हैं। उदाहरण के लिए, क्लाउडफ्लेयर या वोक्सिलिटी जैसे इंटरनेट सेवा प्रदाता, ग्राहकों और पुनर्विक्रेताओं को उनकी बुनियादी सुविधाओं की जानकारी, DDoS आँकड़े, नेटवर्क प्रदर्शन, या डैशबोर्ड नियंत्रणों तक पहुँचने की अनुमति देने के लिए RESTful API का उपयोग करते हैं। ऐसे एपीआई तक पहुंच या तो एपीआई टोकन या ग्राहक स्थिति सत्यापन द्वारा प्रदान की जाती है।

सार्वजनिक एपीआई निहितार्थ
जब एक एपीआई सार्वजनिक हो जाता है तो एक महत्वपूर्ण कारक इसकी इंटरफ़ेस स्थिरता है। एपीआई में परिवर्तन - उदाहरण के लिए फ़ंक्शन कॉल में नए पैरामीटर जोड़ना - उस एपीआई पर निर्भर क्लाइंट के साथ संगतता तोड़ सकता है। जब सार्वजनिक रूप से प्रस्तुत एपीआई के हिस्से परिवर्तन के अधीन होते हैं और इस प्रकार स्थिर नहीं होते हैं, तो किसी विशेष एपीआई के ऐसे हिस्सों को स्पष्ट रूप से अस्थिर के रूप में प्रलेखित किया जाना चाहिए। उदाहरण के लिए, Google Guava लाइब्रेरी में, जो हिस्से अस्थिर माने जाते हैं, और जो जल्द ही बदल सकते हैं, उन्हें जावा एनोटेशन के साथ चिह्नित किया गया है. एक सार्वजनिक एपीआई कभी-कभी खुद के कुछ हिस्सों को पदावनत या रद्द करने की घोषणा कर सकता है। आमतौर पर इसका मतलब यह है कि एपीआई के हिस्से को हटाए जाने के लिए उम्मीदवार माना जाना चाहिए, या पिछड़े असंगत तरीके से संशोधित किया जाना चाहिए। इसलिए, ये परिवर्तन डेवलपर्स को एपीआई के उन हिस्सों से संक्रमण करने की अनुमति देते हैं जिन्हें हटा दिया जाएगा या भविष्य में समर्थित नहीं किया जाएगा। क्लाइंट कोड में नवीन या अवसरवादी उपयोग हो सकते हैं जो एपीआई डिजाइनरों द्वारा अभिप्रेत नहीं थे। दूसरे शब्दों में, महत्वपूर्ण उपयोगकर्ता आधार वाली लाइब्रेरी के लिए, जब कोई तत्व सार्वजनिक एपीआई का हिस्सा बन जाता है, तो इसका उपयोग विविध तरीकों से किया जा सकता है। 19 फरवरी, 2020 को, अकामाई टेक्नोलॉजीज ने दुनिया भर में वित्तीय सेवाओं पर सार्वजनिक एपीआई प्लेटफार्मों को लक्षित करने वाले साइबर अपराधियों की बढ़ती प्रवृत्ति को प्रदर्शित करते हुए अपनी वार्षिक इंटरनेट रिपोर्ट प्रकाशित की। दिसंबर 2017 से नवंबर 2019 तक, अकामाई ने 85.42 बिलियन क्रेडेंशियल उल्लंघन के हमले देखे। लगभग 20%, या 16.55 बिलियन, एपीआई एंडपॉइंट्स के रूप में परिभाषित होस्टनामों के विरुद्ध थे। इनमें से 473.5 मिलियन ने वित्तीय सेवा क्षेत्र के संगठनों को लक्षित किया है।

दस्तावेज़ीकरण
एपीआई प्रलेखन उन सेवाओं का वर्णन करता है जो एक एपीआई प्रदान करता है और उन सेवाओं का उपयोग कैसे करें, जिसका लक्ष्य व्यावहारिक उद्देश्यों के लिए एक ग्राहक को जानने की आवश्यकता होगी।

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

एपीआई का उपयोग कैसे किया जा सकता है, इस पर प्रतिबंध और सीमाएं भी प्रलेखन द्वारा कवर की गई हैं। उदाहरण के लिए, एक एपीआई फ़ंक्शन के लिए प्रलेखन नोट कर सकता है कि इसके पैरामीटर शून्य नहीं हो सकते हैं, या फ़ंक्शन स्वयं थ्रेड सुरक्षा नहीं है। क्योंकि एपीआई प्रलेखन व्यापक होता है, लेखकों के लिए दस्तावेज़ीकरण को अद्यतन रखना और उपयोगकर्ताओं के लिए इसे ध्यान से पढ़ना एक चुनौती है, संभावित रूप से बग पैदा करना। REST API के लिए संदर्भ दस्तावेज़ OpenAPI दस्तावेज़ से स्वचालित रूप से उत्पन्न हो सकते हैं, जो एक मशीन-पठनीय पाठ फ़ाइल है जो OpenAPI विशिष्टता में परिभाषित एक निर्धारित प्रारूप और सिंटैक्स का उपयोग करती है। ओपनएपीआई दस्तावेज़ एपीआई के नाम और विवरण जैसी बुनियादी जानकारी को परिभाषित करता है, साथ ही उन कार्यों का वर्णन करता है जिन तक एपीआई पहुंच प्रदान करता है। एपीआई प्रलेखन को जावा एनोटेशन जैसी मेटाडेटा जानकारी से समृद्ध किया जा सकता है। कस्टम व्यवहार या कस्टम हैंडलिंग को लागू करने के लिए इस मेटाडेटा का उपयोग कंपाइलर, टूल्स और रन-टाइम वातावरण द्वारा किया जा सकता है। डेटा-संचालित तरीके से एपीआई दस्तावेज़ तैयार करना संभव है। किसी दिए गए एपीआई का उपयोग करने वाले कई कार्यक्रमों को देखकर, सामान्य उपयोगों के साथ-साथ आवश्यक अनुबंधों और निर्देशों का अनुमान लगाना संभव है। फिर, खनन किए गए डेटा से प्राकृतिक भाषा उत्पन्न करने के लिए टेम्प्लेट का उपयोग किया जा सकता है।

एपीआई के लिए कॉपीराइट सुरक्षा पर विवाद
2010 में, Oracle Corporation ने Android ऑपरेटिंग सिस्टम में एम्बेडेड जावा के एक नए कार्यान्वयन को वितरित करने के लिए Google पर मुकदमा दायर किया। Google ने Java API को पुन: उत्पन्न करने के लिए कोई अनुमति प्राप्त नहीं की थी, हालाँकि समान OpenJDK प्रोजेक्ट को अनुमति दी गई थी। Google ने अपने API के लिए एक लाइसेंस के लिए बातचीत करने के लिए Oracle से संपर्क किया था, लेकिन भरोसे के मुद्दों के कारण इसे ठुकरा दिया गया था। असहमति के बावजूद, Google ने वैसे भी Oracle के कोड का उपयोग करना चुना। न्यायाधीश विलियम अलसुप ने ओरेकल बनाम गूगल मामले में फैसला सुनाया कि यू.एस. में एपीआई को कॉपीराइट नहीं किया जा सकता है और ओरेकल की जीत से प्रतीकों के एक कार्यात्मक सेट के लिए व्यापक रूप से कॉपीराइट सुरक्षा का विस्तार होगा और सरल सॉफ्टवेयर कमांड के कॉपीराइटिंग की अनुमति होगी:

"To accept Oracle's claim would be to allow anyone to copyright one version of code to carry out a system of commands and thereby bar all others from writing its different versions to carry out all or part of the same commands." अलसुप के फैसले को 2014 में यूनाइटेड स्टेट्स कोर्ट ऑफ अपील्स फॉर द फेडरल सर्किट में अपील पर पलट दिया गया था, हालांकि एपीआई के इस तरह के उपयोग से उचित उपयोग का सवाल अनसुलझा रह गया था। 2016 में, दो सप्ताह के परीक्षण के बाद, एक जूरी ने निर्धारित किया कि जावा एपीआई के Google के पुन: कार्यान्वयन ने उचित उपयोग का गठन किया, लेकिन ओरेकल ने निर्णय की अपील करने की कसम खाई। ओरेकल ने अपनी अपील पर जीत हासिल की, कोर्ट ऑफ अपील्स फॉर द फेडरल सर्किट के फैसले के साथ कि Google द्वारा एपीआई का उपयोग उचित उपयोग के लिए योग्य नहीं था। 2019 में, Google ने संयुक्त राज्य के सर्वोच्च न्यायालय में कॉपीराइट योग्यता और उचित उपयोग दोनों के निर्णयों पर अपील की, और सर्वोच्च न्यायालय ने समीक्षा की अनुमति दी। COVID-19 महामारी के कारण, मामले की मौखिक सुनवाई अक्टूबर 2020 तक विलंबित हो गई। इस मामले का फैसला सुप्रीम कोर्ट ने 6-2 के फैसले के साथ Google के पक्ष में दिया था। न्यायमूर्ति स्टीफन ब्रेयर ने अदालत की राय दी और एक बिंदु पर उल्लेख किया कि घोषित कोड कॉपीराइट के मूल से अधिकांश कंप्यूटर प्रोग्रामों की तुलना में कॉपीराइट योग्य है। इसका अर्थ है कि कॉपीराइट सुरक्षा के मामले में एपीआई में उपयोग किए गए कोड उपन्यासों की तुलना में शब्दकोशों के समान हैं।

उदाहरण

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

यह भी देखें

 * एपीआई परीक्षण
 * एपीआई लेखक
 * संवर्धित वेब
 * कॉलिंग कन्वेंशन
 * कॉमन ऑब्जेक्ट रिक्वेस्ट ब्रोकर आर्किटेक्चर (कॉरबा)
 * आवेदन आभासी मशीनों की तुलना
 * डॉक्यूमेंट ऑब्जेक्ट मॉडल (DOM)
 * डबल-चांस फंक्शन
 * विदेशी फ़ंक्शन इंटरफ़ेस
 * आगे और पीछे के सिरे
 * इंटरफ़ेस (कंप्यूटिंग)
 * इंटरफ़ेस नियंत्रण दस्तावेज़
 * 3डी ग्राफिक्स एपीआई की सूची
 * माइक्रोसर्विसेज
 * नाम मैंगलिंग
 * ओपन एपीआई
 * ओपन सर्विस इंटरफेस डेफिनिशन
 * पार्सिंग
 * प्लग-इन (कंप्यूटिंग)
 * आरएएमएल (सॉफ्टवेयर)
 * सॉफ्टवेयर डेवलपमेंट किट (एसडीके)
 * वेब एपीआई
 * वेब सामग्री विक्रेता
 * एक्सपीकॉम

अग्रिम पठन

 * Argues that "APIs are far from neutral tools" and form a key part of contemporary programming, understood as a fundamental part of culture.
 * What is an API? – in the U.S. Supreme Court opinion, Google v. Oracle 2021, pp. 3–7 – "For each task, there is computer code; API (also known as Application Program Interface) is the method for calling that 'computer code' (instruction – like a recipe – rather than cooking instruction, this is machine instruction) to be carry out"
 * Maury, Innovation and Change – Cory Ondrejka \ February 28, 2014 \ " ...proposed a public API to let computers talk to each other". (Textise URL)

बाहरी संबंध

 * Forrester : IT industry : API Case : Google v. Oracle – May 20, 2021 – content format: Audio with text – length 26:41