在 iPhone 或 iPad 上使用 x-callback-url 搭配「捷徑」
「捷徑」支援 x-callback-url,可在特定互動完成時呼叫 App 來接收回應(回呼)。你可利用「使用 iPhone 或 iPad 上的 URL 方案執行捷徑」中所說明的相同參數,來從 x-callback-url 執行捷徑。例如:
shortcuts://x-callback-url/run-shortcut?name=計算小費&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。此項目可搭配多步驟作業檢查表使用,你可打開 x-callbak-url 來執行捷徑、返回列表和透過 URL 繼續下一個作業。
使用 x-cancel
,你可以提供捷徑在執行完畢前便停止時要啟動的應變 URL。因為捷徑並未完成,因此不會從捷徑提供任何輸出。
使用 x-error
,你可以提供捷徑在執行期間遇到錯誤而無法完成時要啟動的應變 URL。如此一來,你便可使用不同 URL 來解決問題。