在 iPhone 或 iPad 將 x-callback-url 與「捷徑」配搭使用
「捷徑」支援 x-callback-url,可在特定互動完成時呼叫 App 來接收回應(回呼)。你可以利用在 iPhone 或 iPad 使用 URL 架構執行捷徑中所說明的相同參數來從 x-callback-url 執行捷徑。例如:
shortcuts://x-callback-url/run-shortcut?name=%E8%A8%88%E7%AE%97%E5%B0%8F%E8%B2%BB&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 來解決問題。