iPhone या iPad पर शॉर्टकट के साथ x-callback-url का उपयोग करें
शॉर्टकट x-callback-url को सपोर्ट करता है, जिससे कॉलिंग ऐप को रिस्पॉन्स लेने की अनुमति मिलती है (कॉलबैक) जब कोई विशेष इंटरैक्शन पूरा होता है। आप उन्हीं मानदंडों का उपयोग करते हुए x-callback-url से शॉर्टकट रन कर सकते हैं जिनकी चर्चा iPhone या iPad पर URL स्कीम का उपयोग करके शॉर्टकट रन करें में हो चुकी है। उदाहरण के लिए :
शॉर्टकट://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 प्रदान कर सकते हैं जो शॉर्टकट के सफलतापूर्वक रन होने के बाद खुलता है। इसका उपयोग कार्यों के एकाधिक चरणों वाली जाँचसूची के संयोजन में किया जा सकता है, जहाँ आप शॉर्टकट रन करने, सूची पर वापस जाने और URL के ज़रिए अगले कार्य पर मूव करने के लिए x-callback-url खोलते हैं।
x-cancel से, आप एक ऐसा आकस्मिक URL प्रदान कर सकते हैं जो तभी लॉन्च होता है यदि शॉर्टकट के रनिंग पूर्ण होने से पहले रुक जाता है। चूँकि शॉर्टकट पूरा नहीं हुई, इसलिए शॉर्टकट कोई आउटपुट नहीं देता है।
x-error से, आप एक ऐसा आकस्मिक URL प्रदान कर सकते हैं जो तभी लॉन्च होता है यदि शॉर्टकट को रनिंग के दौरान कोई एरर मिलता है और पूर्ण नहीं होता है। इस स्थिति में, आप समस्या का हल करने के लिए कोई दूसरा URL आरंभ कर सकते हैं।