जवाबों:
संसाधन समापन बिंदु का एक संपूर्ण उपसमूह है ।
एक समापन बिंदु अपने आप में वह स्थान है जहाँ किसी सेवा तक पहुँचा जा सकता है:
https://www.google.com # Serves HTML
8.8.8.8 # Serves DNS
/services/service.asmx # Serves an ASP.NET Web Service
एक संसाधन एक या अधिक संज्ञाओं को परोसा जाता है, नामांकित फैशन में दर्शाया जाता है, क्योंकि यह मनुष्य के लिए समझना आसान है:
/api/users/johnny # Look up johnny from a users collection.
/v2/books/1234 # Get book with ID 1234 in API v2 schema.
उपरोक्त सभी को सेवा समापन बिंदु माना जा सकता है, लेकिन केवल निचले समूह को संसाधन माना जाएगा, RESTfully बोलना। शीर्ष समूह इसके द्वारा प्रदान की जाने वाली सामग्री के बारे में स्पष्ट नहीं है।
REST अनुरोध संज्ञाओं (संसाधनों) और क्रियाओं (HTTP विधियों) से बना एक वाक्य जैसा है :
GET
(विधि) नामित उपयोगकर्ता johnny
(संसाधन)।DELETE
(विधि) आईडी 1234
(संसाधन) के साथ पुस्तक ।एंडपॉइंट आमतौर पर एक सेवा को संदर्भित करता है, लेकिन संसाधन का मतलब बहुत सारी चीजें हो सकता है। यहाँ संसाधन के कुछ उदाहरण दिए गए हैं जो उस संदर्भ पर निर्भर हैं जिसका वे उपयोग कर रहे हैं।
कुछ ऐसा जो आपकी मदद के लिए इस्तेमाल किया जा सकता है:
पुस्तकालय एक मूल्यवान संसाधन था, और वह अक्सर इसका उपयोग करता था।
संसाधन प्राकृतिक पदार्थ हैं जैसे पानी और लकड़ी जो जीवन का समर्थन करने में मूल्यवान हैं:
[pl] पृथ्वी के पास सीमित संसाधन हैं, और यदि हम उन्हें रीसायकल नहीं करते हैं तो हम उनका उपयोग करते हैं।
संसाधन भी मूल्य की चीजें हैं जैसे पैसा या संपत्ति जो आप उपयोग कर सकते हैं जब आपको उनकी आवश्यकता होती है:
[pl] सरकार के पास आवश्यक शिक्षकों की संख्या को रखने के लिए संसाधन नहीं हैं।
अवधि संसाधन परिभाषा से अति सूक्ष्म अंतर का एक बहुत है। यह सब उस संदर्भ पर निर्भर करता है जिसमें इसका उपयोग किया गया है।
शब्द संसाधन और समापन बिंदु अक्सर समानार्थक रूप से उपयोग किए जाते हैं। लेकिन वास्तव में उनका मतलब एक ही चीज से नहीं है।
एंडपॉइंट शब्द पर केंद्रित है URL है जिसका उपयोग अनुरोध करने के लिए किया जाता है। संसाधन
शब्द उस डेटा सेट पर केंद्रित होता है जिसे अनुरोध द्वारा लौटाया जाता है।
अब, एक ही संसाधन अक्सर कई द्वारा पहुँचा जा सकता है अलग-अलग समापन बिंदुओं ।
इसके अलावा एक ही समापन बिंदु एक क्वेरी स्ट्रिंग के आधार पर, विभिन्न संसाधनों को वापस कर सकता है ।
आइए हम कुछ उदाहरण देखें:
निम्नलिखित उदाहरणों पर एक नज़र डालें विभिन्न समापन बिंदुओं :
/api/companies/5/employees/3
/api/v2/companies/5/employees/3
/api/employees/3
वे स्पष्ट रूप से सभी दिए गए एपीआई में एक ही संसाधन का उपयोग कर सकते हैं ।
इसके अलावा एक मौजूदा एपीआई को पूरी तरह से बदला जा सकता है। इससे नए एंडपॉइंट बन सकते हैं जो पूरी तरह से नए और अलग URL का उपयोग करके समान पुराने संसाधनों तक पहुंचेंगे:
/api/employees/3
/new_api/staff/3
यदि आपका समापन बिंदु एक संग्रह लौटाता है, तो आप क्वेरी स्ट्रिंग्स का उपयोग करके खोज / फ़िल्टरिंग / छँटाई को लागू कर सकते हैं। परिणामस्वरूप निम्न URL सभी एक ही समापन बिंदु ( /api/companies
) का उपयोग करते हैं , लेकिन वे विभिन्न संसाधन (या संसाधन संग्रह , जो परिभाषा के अनुसार स्वयं में संसाधन हैं) वापस कर सकते हैं :
/api/companies
/api/companies?sort=name_asc
/api/companies?location=germany
/api/companies?search=siemens
संभवतः मेरा एक बहुत अच्छा जवाब नहीं है लेकिन यहाँ जाता है।
चूंकि HTTP पर सही मायने में Restful वेब सेवाओं के साथ अधिक काम करने के बाद, मैंने लोगों को टर्म एंडपॉइंट का उपयोग करने से दूर करने की कोशिश की है क्योंकि इसकी कोई स्पष्ट परिभाषा नहीं है, और इसके बजाय REST की भाषा का उपयोग करें जो संसाधन और संसाधन स्थान हैं।
मेरे दिमाग में, समापन बिंदु एक टीसीपी शब्द है। यह HTTP से जुडा हुआ है क्योंकि URL का हिस्सा एक सुनने वाले सर्वर की पहचान करता है।
इसलिए संसाधन एक नया शब्द नहीं है, मुझे नहीं लगता है, मुझे लगता है कि एंडपॉइंट हमेशा गलत तरीके से बनाया गया था और हमें एहसास हो रहा है कि जैसे ही हम एपीआई की एक शैली के रूप में हमारे आसपास हो रहे हैं ।
संपादित करें
मैंने इस बारे में ब्लॉग किया।
https://medium.com/@lukepuplett/stop-saying-endpoints-92c19e33e819
Https://apiblueprint.org/documentation/examples/13-ame-endpoint.html के अनुसार , दी गई इकाई के भंडारण का एक संसाधन "सामान्य" स्थान है - जैसे / ग्राहक / 30654 / आदेश, जबकि एक समापन बिंदु ठोस कार्रवाई है (HTTP विधि) दिए गए संसाधन पर। तो एक संसाधन में कई समापन बिंदु हो सकते हैं।
एक सर्वर पर विचार करें जिसमें उपयोगकर्ताओं, मिशनों और उनके रिवार्ड पॉइंट्स की जानकारी हो।
स्रोत: एपीआई एंडपॉइंट्स बनाम संसाधन
1. संसाधन विवरण "संसाधन" एक एपीआई द्वारा दी गई जानकारी को संदर्भित करता है।
2. समापन बिंदु और विधियाँ एंडपॉइंट्स संकेत करते हैं कि आप संसाधन का उपयोग कैसे करते हैं, जबकि विधि संसाधन के साथ अनुमत इंटरैक्शन (जैसे GET, POST, या DELETE) को इंगित करती है।
अतिरिक्त जानकारी: 3. पैरामीटर पैरामीटर वे विकल्प हैं जिन्हें आप समापन बिंदु के साथ पारित कर सकते हैं (जैसे कि प्रतिक्रिया प्रारूप को निर्दिष्ट करना या प्रतिक्रिया को प्रभावित करने के लिए दी गई राशि)।
4. अनुरोध उदाहरण अनुरोध उदाहरण में समापन बिंदु का उपयोग करके एक नमूना अनुरोध शामिल है, जिसमें कुछ पैरामीटर कॉन्फ़िगर किए गए हैं।
5. प्रतिक्रिया उदाहरण और स्कीमा प्रतिक्रिया का उदाहरण अनुरोध के उदाहरण से नमूना प्रतिक्रिया दर्शाता है; प्रतिक्रिया स्कीमा प्रतिक्रिया में सभी संभावित तत्वों को परिभाषित करता है।
स्रोत- संदर्भ लिंक