Použitie adresy x-callback-url v apke Skratky na Macu
Apka Skratky podporuje adresy x-callback-url, ktoré volajúcej apke umožňujú prijať odozvu (callback), keď sa dokončí určitá interakcia. Skratky môžete spustiť z adresy x-callback-url pomocou tých istých parametrov, ktoré boli popísané v časti Spustenie skratky pomocou URL schémy na Macu. Napríklad:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Podľa štandardu x-callback-url možno zadať nasledujúce doplnkové parametre:
x-success (nepovinné): URL adresa, ktorá sa otvorí, ak je interakcia úspešná – napríklad po importovaní alebo dokončení spracovania skratky. Po spustení skratky sa k URL adrese pripojí parameter s názvom
result, ktorý obsahuje textový výstup skratky.x-cancel (nepovinné): URL adresa, ktorá sa otvorí, keď užívateľ zruší interakciu.
x-error (nepovinné): URL adresa, ktorá sa otvorí, keď interakcia zlyhá v dôsledku chyby. K URL adrese sa pripojí parameter s názvom
errorMessage, ktorý obsahuje popis chyby.
Pomocou parametra x-success môžete zadať URL adresu, ktorá sa otvorí, ak sa spracovanie skratky úspešne dokončí. Tento parameter možno použiť v kombinácii s viackrokovým kontrolným zoznamom úloh, kde otvoríte adresu x-callback-url na spustenie skratky, návrat do zoznamu a prechod na nasledujúcu úlohu prostredníctvom URL adresy.
Pomocou parametra x-cancel môžete zadať URL adresu pre nepredvídané udalosti, ktorá sa otvorí v prípade, že sa spracovanie skratky pred dokončením zastaví. Keďže sa spracovanie skratky nedokončilo, nie je z nej k dispozícii žiadny výstup.
Pomocou parametra x-error môžete zadať URL adresu pre nepredvídané udalosti, ktorá sa otvorí, keď sa pri spracovaní skratky vyskytne chyba a spracovanie sa nedokončí. V takom prípade môžete spustiť inú URL adresu umožňujúcu vyriešiť vzniknutý problém.