![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D258BE0233D28263F5A/sk_SK/389e356d55e928d40def9c16d476e5e0.png)
Použitie x-callback-url s apkou Skratky na iPhone alebo iPade
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 iPhone alebo iPade. 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.