Використання x-callback-url зі Швидкими командами на iPhone або iPad
«Швидкі команди» підтримує x-callback-url, що дозволяє програмі, що викликає, отримати відповідь (себто зворотний виклик чи колбек), коли відбулася певна взаємодія. Швидкі команди можна запускати з x-callback-url, використовуючи ті самі параметри, що обговорювалися в розділі Запуск швидкої команди через URL-схему на iPhone або iPad. Наприклад:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&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-callback-url для запуску швидкої команди, повернення до списку й переходу до наступного завдання через URL.
З x-cancel ви можете надати аварійну URL-адресу, що відкриється, якщо швидка команда спинилась, перш ніж завершила виконання. Через те, що швидку команду не було завершено, жодних вихідних даних із цієї швидкої команди не надається.
З x-error ви можете надати аварійну URL-адресу, що відкриється, якщо швидка команда стикнулася з помилкою і не змогла завершити виконання. У цьому випадку ви можете обрати іншу URL-адресу для усунення проблеми.