सामग्री

• एपीआई क्या है?
  
  • एपीआई - सुविधा सेट
  • फीचर सेट को कैसे संकलित किया जाता है
  • शब्द "इंटरफ़ेस" क्या करता है
• एपीआई को कैसे कहा जाता है
  
  • एपीआई कॉल सीधे
  • अप्रत्यक्ष एपीआई कॉल
• एपीआई परीक्षण का क्या अर्थ है?
• सारांश

शब्द "एपीआई" रिक्तियों में झिलमिलाता है, यहां तक ​​कि शुरुआती परीक्षकों के लिए भी। या तो एपीआई एपीआई, फिर सोप एपीआई, तो बस एपीआई। यह किस तरह का जानवर है? चलो यह पता लगाने!

"मुझे इसकी आवश्यकता क्यों है?" मैं वास्तव में वेब परीक्षण कर रहा हूँ! अब, अगर मैं स्वचालन में जाता हूं, तो हां ... ठीक है, वे भी उद्यम में इसका परीक्षण कर रहे हैं, मैंने सुना ...

और नहीं! एपीआई के बारे में जानना किसी भी परीक्षक के लिए अच्छा है। क्योंकि इस पर सिस्टम एक-दूसरे से संपर्क करते हैं। और आप इस बातचीत को हर दिन सबसे सरल और बीजपूर्ण साइटों पर भी देखते हैं।

कोई भी भुगतान भुगतान प्रणाली एपीआई के माध्यम से होता है। फिल्म का टिकट खरीदा? एक ऑनलाइन स्टोर में एक टी-शर्ट? एक किताब? जैसे ही आप "भुगतान" पर क्लिक करते हैं, साइट आपको भुगतान प्रणाली से जोड़ती है।

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

• प्रतीक्षा करते हुए ऊब जाना;
• एपीआई कार्य तर्क की जाँच करें

बेशक, मैं दूसरे विकल्प के लिए हूं! तो आइए समझते हैं कि एपीआई क्या है। आप यूट्यूब पर वीडियो देख सकते हैं, या एक लेख के रूप में पढ़ सकते हैं।

एपीआई क्या है?

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

यदि रूसी में अनुवाद किया जाता है, तो यह "अनुबंध" शब्द होगा। कार खरीदने के समझौते के रूप में दो पक्षों के बीच एक समझौता:

• मेरी ज़िम्मेदारी है कि मैं इतनी राशि बना सकूं
• विक्रेता का कर्तव्य कार देना है।

आप अनुवाद कर सकते हैं, हाँ। लेकिन कोई भी no \ _ (one) _ / ¯ ऐसा नहीं करता है

हर कोई "अनुबंध" शब्द का उपयोग करता है। तो स्वीकार कर लिया। इसके अलावा, यह शब्द विकास शैली के नाम में शामिल है:

• कोड पहले - पहले हम कोड लिखते हैं, फिर हम उस पर एक अनुबंध उत्पन्न करते हैं
• अनुबंध पहले - पहले हम एक अनुबंध बनाते हैं, फिर हम उस पर कोड लिखते हैं या उत्पन्न करते हैं (इस लेख में मैं इस शैली के बारे में बात करूंगा)

हम यह नहीं कहते "एक कार की बिक्री के लिए एक अनुबंध"? इसलिए डेवलपर्स "अनुबंध" नहीं कहते हैं। मौन सहमति।

एपीआई - सुविधा सेट

जब आप एक कार खरीदते हैं, तो आप एक अनुबंध बनाते हैं जिसमें आप उन सभी बिंदुओं को लिखते हैं जो आपके लिए महत्वपूर्ण हैं। इसी तरह, कार्यक्रमों के बीच अनुबंध तैयार किया जाना चाहिए। वे संकेत देते हैं कि एक या दूसरे कार्यक्रम को कैसे एक्सेस किया जा सकता है।

तदनुसार, एपीआई प्रश्न का उत्तर देता है "मैं अपने सिस्टम से कैसे संपर्क कर सकता हूं?", और इसमें शामिल हैं:

• वह ऑपरेशन जो हम कर सकते हैं
• इनपुट डेटा
• आउटपुट डेटा (डेटा सामग्री या त्रुटि संदेश)।

यहाँ आप मुझे बता सकते हैं:

- हम्म, पकड़ो। ऑपरेशन, इनपुट डेटा, आउटपुट डेटा - किसी तरह यह सब एक फ़ंक्शन विवरण की तरह है!

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

और हाँ! आप सही होंगे कि परिभाषाएँ समान हैं। क्यों? हां, क्योंकि एपीआई कार्यों का एक समूह है। यह एक कार्य हो सकता है, या कई हो सकते हैं।

फीचर सेट को कैसे संकलित किया जाता है

हाँ, कोई फर्क नहीं पड़ता कि कैसे। जैसा कि डेवलपर चाहता है, यह समूह करेगा। उदाहरण के लिए, आप कार्यक्षमता द्वारा एपीआई को समूहित कर सकते हैं। वह है:

• सिस्टम में प्रवेश करने के लिए अलग एपीआई, जहां पंजीकरण और प्राधिकरण होगा;
• रिपोर्टिंग के लिए अलग एपीआई - रिपोर्ट 1, रिपोर्ट 2, रिपोर्ट 3 ... रिपोर्ट एन। विभिन्न रिपोर्टों के लिए हमारे पास अलग-अलग सूत्र = अलग-अलग कार्य हैं। और हम सभी उन्हें एक सेट में एकत्र करते हैं, रिपोर्टिंग के लिए एपीआई।
• अलग भुगतान प्रणाली एपीआई - प्रत्येक बैंक के साथ काम करने के लिए एक फ़ंक्शन है।
• ...

आप समूह में नहीं कर सकते हैं, लेकिन एक आम एपीआई बना सकते हैं।

एक सामान्य एपीआई बनाया जा सकता है, और बाकी ऑर्डर करने के लिए बनाया जा सकता है। यदि आपके पास एक बॉक्सिंग उत्पाद है, तो इसमें आमतौर पर मानक सुविधाओं का एक सेट शामिल होता है। और किसी भी विशलिस्ट ग्राहकों को अलग से बनाया जाता है।



यह पता चला है कि हमारे सिस्टम में कई अलग-अलग एपीआई हैं, जिनमें से प्रत्येक के लिए हमारे पास एक अनुबंध लिखा गया है। प्रत्येक अनुबंध स्पष्ट रूप से बताता है कि क्या संचालन किया जा सकता है, क्या कार्य होंगे



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



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

शब्द "इंटरफ़ेस" क्या करता है

- एक मिनट रुको, ओलेआ! आपने स्वयं ऊपर लिखा है कि एपीआई एक एप्लीकेशन प्रोग्रामिंग इंटरफ़ेस है। फिर आप अनुबंध के बारे में क्यों बात कर रहे हैं, हालांकि शब्द इंटरफ़ेस है?

हां, क्योंकि प्रोग्रामिंग में एक अनुबंध इंटरफ़ेस है। OOP (ऑब्जेक्ट ओरिएंटेड प्रोग्रामिंग) के क्लासिक विवरण में 3 व्हेल हैं:

1. कैप्सूलीकरण
2. विरासत
3. बहुरूपता

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

हमेशा नहीं कार्यक्रम एक ग्राफिकल इंटरफ़ेस प्रदान करता है। यह एक SOAP, REST इंटरफ़ेस या दूसरा API हो सकता है। इस इंटरफ़ेस का उपयोग करने के लिए, आपको समझना चाहिए:

• क्या दर्ज करें;
• क्या निकलता है;
• क्या अपवादों को संभालने की जरूरत है।

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

एपीआई को कैसे कहा जाता है

आप एपीआई को प्रत्यक्ष या अप्रत्यक्ष रूप से कह सकते हैं।

सीधे:

1. सिस्टम अपने भीतर फंक्शन्स को कॉल करता है।
2. सिस्टम दूसरे सिस्टम के तरीके को कॉल करता है
3. आदमी एक विधि कहता है
4. ऑटोटेस्ट्स तरीकों को खींचते हैं

परोक्ष रूप से:

1. उपयोगकर्ता GUI के साथ काम करता है

एपीआई कॉल सीधे

1. सिस्टम अपने भीतर फंक्शन्स को कॉल करता है

कार्यक्रम के विभिन्न भाग किसी न किसी तरह एक दूसरे से संवाद करते हैं। वे प्रोग्राम स्तर पर, यानी एपीआई स्तर पर ऐसा करते हैं!

यह उपयोग करने का सबसे आसान तरीका है, क्योंकि एपीआई के लेखक को बुलाया जा रहा है। और वह उसका उपभोक्ता है! इसलिए, अप्रासंगिक प्रलेखन के साथ कोई समस्या नहीं है =)

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

2. सिस्टम दूसरे सिस्टम का तरीका कहता है

लेकिन यह एक विशिष्ट मामला है जो परीक्षक इंटीग्रेटर्स में परीक्षण करते हैं। या परीक्षक जो किसी और के साथ अपने सिस्टम के एकीकरण का परीक्षण करते हैं।

एक प्रणाली एपीआई के माध्यम से खींचती है, दूसरी प्रणाली की कुछ विधि। वह किसी अन्य सिस्टम से डेटा प्राप्त करने का प्रयास कर सकती है। या इसके विपरीत, इस सिस्टम में डेटा भेजें।

मान लीजिए कि मैंने दादता से संकेतों को अपने ऑनलाइन स्टोर से जोड़ने का फैसला किया, ताकि उपयोगकर्ता आसानी से वितरण पते में प्रवेश कर सके।

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

• वह मेरी वेबसाइट पर एक पत्र डालता है
• मेरी साइट एपीआई दादा संकेत पर एक अनुरोध भेजती है
• दादाजी ने उत्तर दिया
• मेरी साइट इसे संसाधित करती है और उपयोगकर्ता को परिणाम प्रदर्शित करती है।

बहुत सारे कदम हैं! और इसलिए प्रत्येक चरित्र में प्रवेश किया। उपयोगकर्ता इस इंटरैक्शन को नहीं देखता है, लेकिन यह है।

और, ज़ाहिर है, उस मामले के बारे में मत भूलो जब हम एपीआई विधि विकसित करते हैं। जिसे केवल SOAP के माध्यम से बुलाया जा सकता है, यह इंटरफ़ेस में पाया जाना कहीं नहीं है। ग्राहक ने जो आदेश दिया, हमने (\ _ (_) _ / we किया

एक उदाहरण उपयोगकर्ताओं में पाया जा सकता है। मैजिकसर्च विधि वास्तविक घटनाओं पर आधारित है। यद्यपि मुझे स्वीकार करना चाहिए, मूल तर्क में और भी अधिक परिष्कृत था, मैंने इसे अपनी साइट पर समायोजित किया।

लेकिन यहां ट्रिक यह है कि सिस्टम में यूजर इंटरफेस में केवल एक नियमित खोज है, बस एक इनपुट लाइन है। ठीक है, शायद कुछ फिल्टर। लेकिन एकीकरण के लिए अतिरिक्त सुविधाओं की एक पूरी गुच्छा की आवश्यकता थी, जो SOAP विधि के माध्यम से किया गया था।

सुपर-सर्च कार्यक्षमता केवल एपीआई द्वारा उपलब्ध है, इंटरफ़ेस में उपयोगकर्ता इसे महसूस नहीं करता है।

इस मामले में, आपके पास आमतौर पर TK होता है, जिसके अनुसार एपीआई विधि काम करती है। आपका कार्य इसे जांचना है। एक परीक्षक का एक विशिष्ट कार्य, बस मानक परीक्षण डिजाइन में जोड़ें एपीआई परीक्षण की सुविधाओं का परीक्षण, और यह टोपी के बारे में सब है!

(क्या वास्तव में एपीआई में परीक्षण करने की आवश्यकता है - मैं थोड़ी देर बाद एक अलग लेख में बताऊंगा)

3. व्यक्ति विधि कहता है

कारण अलग हैं:

1. काम में तेजी लाने के लिए
2. बग को स्थानीय करने के लिए (समस्या कहां है? सर्वर या क्लाइंट पर?)
3. बिना धार के तर्क का परीक्षण करना

यदि सिस्टम एक एपीआई प्रदान करता है, तो आमतौर पर इसे ग्राफिकल इंटरफेस के माध्यम से करने की तुलना में इसे yank करना अधिक आसान होता है। इसके अलावा, एपीआई कॉल को टूल में सेव किया जा सकता है। एक बार बचाया - आप किसी भी आधार पर आवेदन करते हैं, भले ही इसे दिन में 10 बार साफ किया जाए।

एक उदाहरण के लिए हम फिर से उपयोगकर्ताओं के पास जाते हैं । यदि हम एक उपयोगकर्ता बनाना चाहते हैं, तो हमें बहुत सारे फ़ील्ड भरने होंगे!



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

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

और इस मामले में, स्वचालन की भूमिका ... पोस्टमैन। एक उपयोगकर्ता CreateUser REST अनुरोध के माध्यम से बनाया जा सकता है। एक बार सामान्य "वास्तविक" डेटा पंजीकृत होने के बाद, हर बार जब हम इसका उपयोग करते हैं। लाभ!

फॉर्म को मैन्युअल रूप से भरने के बजाय (1 मिनट विचारपूर्वक फ़ील्ड को "lprulpk") के साथ भरना, हमें "सेंड" बटन दबाने का 1 सेकंड मिलता है। इस मामले में, मूल्य बहुत अधिक पर्याप्त होंगे।

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

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

4. ऑटोटेस्ट्स तरीकों को खींचते हैं

एक विशिष्ट स्वचालन पिरामिड है:

• जीयूआई परीक्षण एक ईमानदार परीक्षण है, "उपयोगकर्ता इसे कैसे करेगा।"
• एपीआई परीक्षण - हम नीचे के स्तर तक उतरते हैं, शानदार बाहर फेंकते हैं।
• यूनिट परीक्षण - एकल फ़ंक्शन के लिए परीक्षण

परीक्षण में उपयोग किए जाने वाले शब्दों पर एपीआई संकेत देता है at

मान लें कि हमारे पास है:

• ऑपरेशन : रिपोर्ट डाउनलोड;
• इनपुट पर : मैनुअल या स्वचालित समायोजन या कुछ अन्य स्थानों से डेटा;
• आउटपुट : कुछ नियमों के अनुसार बनाई गई रिपोर्ट

रिपोर्ट निर्माण नियम:

• सेल 1 : एक्स - वाई
• सेल 2 : जेड * 6
• ...

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

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

यूनिट परीक्षण तब होते हैं जब हम प्रत्येक फ़ंक्शन को अलग-अलग परीक्षण करते हैं। हम सेल 1 के लिए गणना को अलग से देखते हैं, सेल 2 के लिए अलग से, और इसी तरह। इस तरह के परीक्षण सबसे जल्दी पीछा किए जाते हैं और उन पर कीड़े को स्थानीय बनाना आसान होता है।

अप्रत्यक्ष एपीआई कॉल

जब उपयोगकर्ता GUI के साथ काम करता है, वास्तव में, वह एपीआई के साथ भी काम करता है। वह बस इसके बारे में नहीं जानता है, उसे बस इसकी आवश्यकता नहीं है।

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



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



और रिपोर्ट बिल्डिंग फ़ंक्शन पहले से ही 10 विभिन्न अन्य कार्यों को कॉल कर सकता है, अगर यह आवश्यक है।

और अब उपयोगकर्ता उसके सामने एक तैयार रिपोर्ट देखता है। उसने बिना जाने-पहचाने कॉम्प्लेक्स एपीआई को भी बुला लिया!

एपीआई परीक्षण का क्या अर्थ है?

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

लेकिन यह एक स्थापित अभिव्यक्ति है। आप इसका उपयोग कर सकते हैं और "एपीआई परीक्षण" कह सकते हैं। और जब हम इसके बारे में बात करते हैं, तो हमारा मतलब होता है:

• एपीआई स्तर के स्व-परीक्षण
• या दो अलग-अलग प्रणालियों के बीच एकीकरण।

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



जब हम API की जाँच करने के बारे में बात करते हैं, तो अक्सर हम दूरस्थ API का परीक्षण करते हैं। जब हमारे पास विभिन्न कंप्यूटरों पर स्थित दो प्रणालियाँ होती हैं जो किसी न किसी तरह एक दूसरे से संवाद करती हैं।

और यदि आप रिक्ति में "एपीआई परीक्षण" देखते हैं, तो सबसे अधिक संभावना है कि यह SOAP या REST सेवा को कॉल करने और परीक्षण करने की क्षमता है। हालांकि यह हमेशा स्पष्ट करने लायक है!

सारांश

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

अनुबंध में शामिल हैं:

• वह ऑपरेशन जो हम कर सकते हैं
• इनपुट डेटा
• आउटपुट डेटा (डेटा सामग्री या त्रुटि संदेश)। "।