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