高级快捷指令(十)：使用URL方案——使用X-Callback-URL

配合“快捷指令”使用 X-Callback-URL

“快捷指令”支持 X-Callback-URL，允许调用 App 在特定交互完成后接收回复（即 Callback）。您可以用与使用 URL 方案运行快捷指令中讨论的相同参数从 X-Callback-URL 运行快捷指令。例如：

shortcuts://x-callback-url/run-shortcut?name=%E8%AE%A1%E7%AE%97%E5%B0%8F%E8%B4%B9&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 中连接多步的任务核对清单，在 OmniFocus 中打开 X-Callback-URL 以运行快捷指令，然后通过 URL 返回清单并移到下一个任务。

通过 x-cancel，您可以提供应变 URL，如果快捷指令在运行完成前停止，它就会启动。由于快捷指令未运行完成，它不会提供输出。

通过 x-error，您可以提供应变 URL，如果快捷指令在运行时遇到错误而无法完成，它就会启动。在此情况下，您可以启动另一个 URL 来处理这个问题。