Shortcuts के साथ X-callback-url का उपयोग करें
Shortcuts x-callback-url को सपोर्ट करता है, जिससे कॉलिंग ऐप को रिस्पॉन्स लेने की अनुमति मिलती है (कॉलबैक) जब कोई विशेष इंटरैक्शन पूरा होता है। आप उन्हीं पैरामीटर की मदद से x-callback-url से शॉर्टकट इम्पोर्ट और रन कर सकते हैं जिनकी चर्चा URL स्कीम और और URL स्कीम की मदद से शॉर्टकट इम्पोर्ट करेंकी मदद से शॉर्टकट रन करना, में हो चुकी है। यहाँ एक उदाहरण है :
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
x-callback-url स्टैंडर्ड के अनुसार, निम्नलिखित अतिरिक्त पैरामीटर प्रदान किए जा सकते हैं :
x-success (वैकल्पिक) : एक ऐसा URL जो तभी खुलता है जब इंटरैक्शन सफल होता है—उदाहरण के लिए, शॉर्टकट इम्पोर्ट होने के बाद या रनिंग पूरा होने के बाद। यदि कोई शॉर्टकट रन करता है, तो
resultनामक पैरामीटर URL से जुड़ जाता है और उसमें शॉर्टकट का टेक्सचुअल आउटपुट होता है।x-cancel (वैकल्पिक) : एक ऐसा URL जो तभी खुलता है जब यूज़र द्वारा इंटरैक्शन कैंसल होता है।
x-error (वैकल्पिक) : एक ऐसा URL जो तभी खुलता है जब कोई एरर उत्पन्न होने के कारण इंटरैक्शन विफल हो जाता है।
errorMessageनामक पैरामीटर URL से जुड़ जाता है और उसमें एरर का विवरण होता है।
X-success से, आप एक ऐसा URL प्रदान कर सकते हैं जो शॉर्टकट के सफलतापूर्वक रन होने के बाद खुलता है। यह OmniFocus में टास्क के मल्टिस्टेप चेकलिस्ट के साथ उपयोगी हो सकता है, जहाँ शॉर्टकट रन करने, सूची में वापस जाने और URL के जरिए अगले टास्क में जाने के लिए आप x-callback-url खोलते हैं।
x-cancel से, आप एक ऐसा आकस्मिक URL प्रदान कर सकते हैं जो तभी लॉन्च होता है यदि शॉर्टकट के रनिंग पूर्ण होने से पहले रुक जाता है। चूँकि शॉर्टकट पूरा नहीं हुई, इसलिए शॉर्टकट कोई आउटपुट नहीं देता है।
x-error से, आप एक ऐसा आकस्मिक URL प्रदान कर सकते हैं जो तभी लॉन्च होता है यदि शॉर्टकट को रनिंग के दौरान कोई एरर मिलता है और पूर्ण नहीं होता है। इस स्थिति में, आप समस्या का हल करने के लिए कोई दूसरा URL आरंभ कर सकते हैं।