Використання x-callback-url зі Швидкими командами
«Швидкі команди» підтримує x-callback-url, що дозволяє програмі, що викликає, отримати відповідь (себто зворотний виклик чи колбек), коли відбулася певна взаємодія. Ви можете імпортувати й запускати швидкі команди з x-callback-url за допомогою тих самих параметрів, що обговорювалися в Виконання швидкої команди за допомогою URL-схеми і Імпорт швидкої команди за допомогою URL-схеми. До прикладу:
shortcuts://x-callback-url/run-shortcut?name=Calculate Tip&input=text&text=24.99&x-success=...&x-cancel=...
Згідно з стандартом x-callback-url такі додаткові параметри можна надавати:
x-success (необовʼязково): URL-адреса, що відкривається, коли взаємодія успішна, наприклад, після того, як швидку команду імпортовано або виконано. Якщо швидка команда виконується, параметр під назвою
результатдолучається до URL-адреси і містить текстові вихідні дані швидкої команди.x-cancel (необовʼязково): URL-адреса, що відкривається, коли взаємодію скасовує користувач.
x-error (необовʼязково): URL-адреса, що відкривається, коли відбувається збій взаємодії через виникнення помилки. Параметр під назвою
errorMessageдодається в кінець URL-адреси та містить опис цієї помилки.
З x-success ви можете надати URL-адресу, що відкривається, коли швидка команда успішно завершила виконання. Це може використовуватися у поєднанні з багатокроковим контрольним списком завдань в OmniFocus, де ви відкриваєте x-callback-url для запуску швидкої команди, повернення до списку і переходу до наступного завдання через URL.
З x-cancel ви можете надати аварійну URL-адресу, що відкриється, якщо швидка команда спинилась, перш ніж завершила виконання. Через те, що швидку команду не було завершено, жодних вихідних даних із цієї швидкої команди не надається.
З x-error ви можете надати аварійну URL-адресу, що відкриється, якщо швидка команда стикнулася з помилкою і не змогла завершити виконання. У цьому випадку ви можете обрати іншу URL-адресу для усунення проблеми.