Używanie protokołu x-callback-url w aplikacji Skróty
Aplikacja Skróty obsługuje protokół x-callback-url, umożliwiający aplikacji wysyłającej na odebranie odpowiedzi (zwrotu) po zakończeniu określonej interakcji. Adres URL x-callback pozwala na importowanie i uruchamianie skrótów przy użyciu takich samych parametrów, jak omówione w sekcjach: Uruchamianie skrótu przy użyciu schematu URL oraz Importowanie skrótu przy użyciu schematu URL. Oto przykład:
shortcuts://x-callback-url/run-shortcut?name=Oblicz%20napiwek&input=text&text=24.99&x-success=...&x-cancel=...
Zgodnie ze standardem x-callback-url możesz podać następujące dodatkowe parametry:
x-success (opcjonalnie): URL otwierany w przypadku powodzenia interakcji — na przykład po zaimportowaniu skrótu lub zakończeniu jego działania. Po uruchomieniu skrótu do adresu URL dodawany jest parametr
resultzawierający tekst z danymi wyjściowymi skrótu.x-cancel (opcjonalnie): URL otwierany w przypadku anulowania interakcji przez użytkownika.
x-error (opcjonalnie): URL otwierany w przypadku niepowodzenia interakcji z powodu wystąpienia błędu. Do adresu URL dodawany jest parametr
errorMessagezawierający opis błędu.
Parametr x-success pozwala na podanie adresu URL otwieranego po pomyślnym zakończeniu działania skrótu. Można go użyć w połączeniu z listą zadań w aplikacji OmniFocus, z której otwierasz adres URL x-callback, aby uruchomić skrót, a następnie wracasz do listy i przechodzisz do następnego zadania przy użyciu adresu URL.
Parametr x-cancel pozwala na podanie adresu URL na wypadek przerwania działania skrótu przed jego zakończeniem. Dane wyjściowe skrótu nie są wówczas podawane, ponieważ działanie skrótu nie zostało ukończone.
Parametr x-error pozwala na podanie adresu URL na wypadek wystąpienia błędu podczas wykonywania skrótu, w wyniku którego działanie skrótu nie zostaje ukończone. W tej sytuacji możesz otworzyć inny URL, aby obsłużyć ten problem.