vremn

Использование x-callback-url в программе «Быстрые команды»

Программа «Быстрые команды» поддерживает x-callback-url, что позволяет вызывающей программе получить ответ (callback) по завершении определенного типа взаимодействия. Можно использовать x-callback-url для импорта и запуска быстрых команд, задавая значения для тех же параметров, которые описаны в разделах Запуск быстрой команды с использованием схемы 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-адрес.
-----------------------------------------------------------------------------

-----------------------------------------------------------------------------
https://support.apple.com/ru-ru/guide/shortcuts/apdcd7f20a6f/2.0/ios/12.0

Apple Support

Использование x-callback-url с приложением «Быстрые команды» на iPhone или iPad

Приложение «Быстрые команды» поддерживает x-callback-url, что позволяет вызывающему приложению получить ответ (callback) по завершении определенного типа взаимодействия.

7 views13:09