Использование x-callback-url в приложении «Быстрые команды»
Приложение «Быстрые команды» поддерживает x-callback-url, что позволяет вызывающему приложению получить ответ (callback) по завершении определенного типа взаимодействия. Из x-callback-url можно запускать быстрые команды, используя параметры, описанные в разделе «Запуск быстрой команды с использованием схемы URL». Например:
shortcuts://x-callback-url/run-shortcut?name=Расчет%20чаевых&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, работая в которой, можно открыть x-callback-url, чтобы запустить быструю команду, вернуться к списку и перейти к следующей задаче через URL-адрес.
Используя параметр x-cancel, можно указать «экстренный» URL-адрес, который откроется, если быстрая команда прервется до своего полного выполнения. В этом случае выходных данных от быстрой команды получен не будет, так как она не выполняется полностью.
Используя параметр x-error, можно указать «экстренный» URL-адрес, который откроется, если выполнение быстрой команды не удастся завершить из-за возникшей ошибки. В таком случае чтобы обойти проблему, Вы сможете открыть другой URL-адрес.