शॉर्टकट में पहले API के लिए अनुरोध करें
अपने पहले API का अनुरोध करने के लिए, आप URL बनाते हैं जो उस API “endpoint” को इंगित करता जिससे आप बात करना चाहते हैं और फिर उस URL को Get Contents of URL क्रिया में पास करता है। जब शॉर्टकट रन होता है, तो यह क्रिया API अनुरोध करता है।
API अनुरोध बनाएँ
Dark Sky’s Forecast एंडपॉइंट के लिए URL अनुरोध को फ़ोर्मैट करने की जरूरत होती है जैसे :
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
ब्रैकेट में मौजूद टेक्स्ट API की और उस लोकेशन के साथ भर जाएगा जिसके लिए आप फ़ोरकास्ट डेटा चाहते हैं।
Shortcuts ऐप में, पहले Text ऐक्शन में Dark Sky से अपना API की रखें, जो वैरिएबल के रूप में URL ऐक्शन में पास होता है।
LATऔरLONGवैल्यूज पहले से ही37.8267और-122.4233पर सेट हैं, जो San Francisco में Alcatraz Island के लिए कॉर्डिनेट्स है। (आप उन वैल्यूज को अलग लोकेशन में बदल सकते हैं।)Get Current Location ऐक्शन आजमाने की कोशिश करें और URL ऐक्शन में लैटिट्यूड और लॉन्गिट्यूड के लिए सेट म्यूज़िक वैरिएबल के रूप में रखें ताकि शॉर्टकट रन करने पर स्थानीय मौसम का आंकड़ा पा सकें।
Get Contents of URL के साथ API अनुरोध करें
Shortcuts ऐप के शॉर्टकट संपादक में, Get Contents of URL को Advanced पर सेट करें।
API अनुरोधों के लिए आप निम्नलिखित विकल्पों को उपलब्ध बना सकते हैं :
GETआपको रीड करने के लिए API से डेटा वापस पाने की अनुमति देता है।POSTआपको नया डेटा तैयार करने की अनुमति देता है।PUTऔरPATCHआपको क्रमश : डेटा को बदलकर या रूपांतरित कर इसे अपडेट करने की अनुमति देता है।DELETEआपको URL अनुरोध में निर्दिष्ट ऑब्जेक्ट को हटाने की अनुमति देता है।
इस उदाहरण के लिए,
GETअनुरोध का उपयोग करके Dark Sky API से डेटा वापस पाएँ।अब URL क्रिया के पास आपका अनुरोध है और Get Contents of URL क्रिया को
GETडेटा पर सेट किया गया है, आप API अनुरोध बनाने के लिए तैयार हैं।नोट : Get Contents of URL क्रिया के
POST,PUT, याPATCHपर स्विच होने पर, Request Body नामक पैरामीटर जोड़ा जाता है। Request Body आपको JSON, एक फ़ॉर्म, एक फ़ाइल को एक अनुरोध के रूप में API को भेजने की अनुमति देता है। यह आपको नया डेटा मैनुअली दर्ज करने या वैरिएबल की मदद से दर्ज करने की सुविधा देता है ताकि आप एंट्री बनाने, बदलने या रूपांतरित करने के लिए API को डेटा भेजा जा सके।
को टैप करके शॉर्टकट की जाँच करें (शॉर्टकट में मौजूद Quick Look क्रिया आपको API द्वारा वापस किए जाने वाले डेटा को प्रीव्यू करने की अनुमति देता है)।
बधाइयाँ, आपने शॉर्टकट की मदद से अपना पहला API अनुरोध बनाया है।
पहली नजर में, ऐसा लगता है कि API ढेर सारे अनजाने फ़ॉर्मैटेड टेक्स्ट रिटर्न करता है। गहनता से जाँच करने पर, आप देखेंगे कि टेक्स्ट में मौसम पूर्वानुमान सूचना मौजूद है। यह मौसम सूचना JSON में एनकोडेड होती है, जो अर्थ है JavaScript Object Notation।
JSON के साथ काम करने के बारे में जानने और Dark Sky API उदाहरण के साथ जारी रहने के लिए शॉर्टकट में JSON के उपयोग के बारे मेंदेखें।