Použití URL s daty x-callback se Zkratkami na iPhonu nebo iPadu
Zkratky podporují URL s daty x-callback, což umožňuje předat volající aplikaci odezvu (callback), jakmile je interakce dokončena. Zkratky můžete spouštět pomocí URL s daty x-callback a používat přitom parametry popsané v tématu Spuštění zkratky pomocí schématu URL na iPhonu nebo iPadu. Příklad:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Prostřednictvím standardu x-callback-url lze zadat následující doplňkové parametry:
x-success (volitelné): URL, které se otevře, pokud je interakce úspěšná – například po naimportování nebo dokončení zpracování zkratky. Jakmile je zkratka spuštěna, je k URL připojen parametr
result, obsahující textový výstup zkratky.x-cancel (volitelné): URL, které se otevře, když je interakce zrušena uživatelem.
x-error (volitelné): URL, které se otevře, když se interakce nezdaří následkem chyby. K URL je připojen parametr
errorMessageobsahující popis chyby.
Pomocí parametru x-success můžete zadat URL, které se otevře, pokud je zpracování zkratky úspěšně dokončeno. Tento parametr lze použít v kombinaci s vícekrokovým kontrolním seznamem úloh, v němž otevřete x-callback-url pro spuštění zkratky, návrat do seznamu a přechod na následující úlohu prostřednictvím URL.
Pomocí parametru x-cancel můžete zadat URL pro nepředvídané události, které se spustí v případě, že se zpracování zkratky před dokončením zastaví. Vzhledem k tomu, že zpracování zkratky nebylo dokončeno, není z ní k dispozici žádný výstup.
Pomocí parametru x-error můžete zadat URL pro nepředvídané události, které se spustí, když se při zpracování zkratky vyskytne chyba a zpracování se nedokončí. V takovém případě můžete spustit jiné URL umožňující potíže vyřešit.