रेस्ट एपीआई का परिचय - रेस्टफुल वेब सर्विसेज

यह लेख Restful वेब सेवाओं और REST और HTTP के अवलोकन का परिचय है।

वह REST API विकसित करने के बारे में कई पोस्ट शुरू करती है:

• रेस्ट एपीआई का परिचय - रेस्टफुल वेब सर्विसेज
• REST और SOAP के बीच अंतर
• REST API डेवलपमेंट - कॉन्ट्रैक्ट फर्स्ट (अनुबंध पहले) क्या है?
• REST API डेवलपमेंट - कोड फर्स्ट (कोड फर्स्ट) क्या है?
• REST API - HATEOAS क्या है?
• अन्य एपीआई अनुशंसाएँ - जावा और वसंत में वेब सेवा डिज़ाइन उदाहरण

REST का मतलब है, प्रेजेंटेशन स्टेट ट्रांसफर (विकिपीडिया: "ट्रांसफर प्रेजेंटेशन स्टेट")। आधुनिक दुनिया में एपीआई बनाने के लिए यह एक लोकप्रिय वास्तुशिल्प दृष्टिकोण है।

आप सीखेंगे:

• REST क्या है?
• REST API किस पर आधारित है?
• REST API बनाते समय HTTP का उपयोग कैसे किया जाता है?
• एक संसाधन क्या है?
• आप REST API संसाधनों को कैसे परिभाषित करते हैं?
• REST API विकसित करने के लिए सर्वोत्तम अभ्यास क्या हैं?

REST क्या है?

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

HTTP ओवरव्यू

आइए पहले ब्राउज़र खोलें और वेब पेज पर जाएं:



और फिर परिणाम पृष्ठों में से एक पर क्लिक करें:



अगला, हम उस पृष्ठ पर लिंक पर क्लिक कर सकते हैं जिस पर हम हैं:



और दूसरे पेज पर जाएं:



यह आमतौर पर हम वेब ब्राउज़ करते हैं।

जब हम इंटरनेट ब्राउज़ करते हैं, तो बहुत सी चीजें पर्दे के पीछे होती हैं। ब्राउज़र और सर्वर पर उन वेबसाइटों पर चलने वाले सर्वरों के बीच क्या हो रहा है, इसका एक सरल दृष्टिकोण निम्नलिखित है:

HTTP प्रोटोकॉल

जब आप ब्राउज़र में URL दर्ज करते हैं, उदाहरण के लिए www.google.com , तो URL पर निर्दिष्ट सर्वर पर सर्वर को एक अनुरोध भेजा जाता है। फिर यह सर्वर प्रपत्र और उत्तर जारी करता है। इन अनुरोधों और प्रतिक्रियाओं का प्रारूप महत्वपूर्ण है। ये प्रारूप HTTP प्रोटोकॉल हाइपर टेक्स्ट ट्रांसफर प्रोटोकॉल द्वारा परिभाषित किए गए हैं।

जब आप ब्राउज़र में URL टाइप करते हैं, तो यह निर्दिष्ट सर्वर को एक GET अनुरोध भेजता है। सर्वर तब एक HTTP प्रतिसाद के साथ प्रतिक्रिया करता है जिसमें HTML डेटा - हाइपर टेक्स्ट मार्कअप लैंग्वेज होता है । ब्राउज़र तब इस HTML कोड को प्राप्त करता है और इसे स्क्रीन पर प्रदर्शित करता है।

मान लीजिए कि आप तत्वों की सूची के साथ एक वेब पेज पर एक फॉर्म भरते हैं। इस स्थिति में, जब आप सबमिट बटन पर क्लिक करते हैं, तो HTTP POST अनुरोध सर्वर पर भेजा जाता है।

HTTP और Restful वेब सेवाएँ

HTTP वेब सेवाएँ बनाने के लिए एक मूल परत प्रदान करता है। इसलिए, HTTP को समझना महत्वपूर्ण है। यहाँ कुछ प्रमुख सार हैं।

संसाधन

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

• विशिष्ट उपयोगकर्ता
• विशिष्ट कार्य
• कार्य सूची

संसाधन यू.आर.आई.

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

• उपयोगकर्ता बनाएं: POST / उपयोगकर्ता
• उपयोगकर्ता हटाएं: DELETE / उपयोगकर्ता / 1
• सभी उपयोगकर्ता प्राप्त करें : GET / उपयोगकर्ता
• एक उपयोगकर्ता प्राप्त करें: GET / उपयोगकर्ता / 1

बाकी और संसाधन

यह ध्यान रखना महत्वपूर्ण है कि REST के साथ आपको संसाधनों के संदर्भ में अनुप्रयोग के बारे में सोचना होगा:
निर्धारित करें कि आप बाहरी दुनिया के लिए कौन से संसाधन खोलना चाहते हैं।
इन संसाधनों पर कार्रवाई करने के लिए HTTP प्रोटोकॉल द्वारा पहले से परिभाषित क्रियाओं का उपयोग करें।

यहां बताया गया है कि REST सेवा आमतौर पर किस प्रकार लागू की जाती है:

• डेटा विनिमय प्रारूप : कोई प्रतिबंध नहीं हैं। JSON एक बहुत ही लोकप्रिय प्रारूप है, हालांकि अन्य जैसे XML का उपयोग किया जा सकता है।
• परिवहन : हमेशा HTTP। REST पूरी तरह से HTTP- आधारित है।
• सेवा की परिभाषा : इसके लिए कोई मानक नहीं है, और REST लचीला है। यह कुछ परिदृश्यों में एक खामी हो सकती है, क्योंकि उपभोग करने वाले एप्लिकेशन को अनुरोध और प्रतिक्रिया स्वरूपों को समझने की आवश्यकता हो सकती है। हालाँकि, वेब अनुप्रयोग परिभाषा भाषाएँ जैसे WADL (वेब ​​अनुप्रयोग परिभाषा भाषा) और स्वैगर व्यापक रूप से उपयोग की जाती हैं।

REST संसाधनों पर ध्यान केंद्रित करता है और HTTP का उपयोग करके आप उनके साथ कितनी कुशलता से संचालन करते हैं।

HTTP घटक

HTTP निम्नलिखित अनुरोध संरचना को परिभाषित करता है:

• अनुरोध पंक्ति ( अनुरोध पंक्ति ) - संदेश के प्रकार को परिभाषित करता है
• अनुरोध शीर्षलेख ( हेडर फ़ील्ड ) - संदेश निकाय, ट्रांसमिशन मापदंडों और अन्य जानकारी को चिह्नित करता है
• संदेश का मुख्य भाग ( शरीर ) - वैकल्पिक

प्रतिक्रिया संदेश के लिए HTTP निम्नलिखित संरचना को परिभाषित करता है:

• स्थिति कोड और स्थिति संदेश सहित स्थिति लाइन
• प्रतिक्रिया हैडर फ़ील्ड
• संदेश का अतिरिक्त निकाय ( निकाय )

HTTP अनुरोध विधि

HTTP अनुरोध में उपयोग की जाने वाली विधि इंगित करती है कि आप इस अनुरोध के साथ क्या कार्य करना चाहते हैं। महत्वपूर्ण उदाहरण:

• प्राप्त करें : विस्तृत संसाधन जानकारी प्राप्त करें
• POST : एक नया संसाधन बनाएँ
• PUT : किसी मौजूदा संसाधन को अपडेट करें
• DELETE : संसाधन हटाएं

HTTP प्रतिक्रिया स्थिति कोड

HTTP प्रतिक्रिया में स्थिति कोड हमेशा मौजूद होता है। विशिष्ट उदाहरण:

• 200 - सफलता
• 404 - पृष्ठ नहीं मिला

इस मुद्दे पर एक लेखक का वीडियो है

सारांश

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

अंत में, हमने देखा कि बाहरी दुनिया को संसाधन प्रदान करने के लिए HTTP द्वारा दी जाने वाली सुविधाओं में REST सेवाएँ किस प्रकार सर्वोत्तम उपयोग करती हैं। REST संसाधनों के प्रस्तुति प्रारूपों या किसी सेवा की परिभाषा पर कोई प्रतिबंध नहीं लगाता है।

अतिरिक्त पढ़ने

रैस्टफुल आर्किटेक्चर की नींव
REST API का विकास करना