Use x-callback-url com o Atalhos do iPhone ou iPad
O Atalhos é compatível com x-callback-url, o que permite ao app chamador receber uma resposta (“callback” ou retorno) quando uma interação específica é concluída. Você pode executar atalhos a partir de um x-callback-url usando os mesmos parâmetros mencionados em Execute um atalho usando um esquema de URL no iPhone ou iPad. Por exemplo:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Conforme o padrão de x-callback-url, é possível fornecer os parâmetros adicionais a seguir:
x-success — opcional: um URL que se abre quando a interação é bem-sucedida, por exemplo, após a importação de um atalho ou quando ele termina de ser executado. Se um atalho é executado, um parâmetro chamado
result(resultado) é afixado ao URL, contendo o resultado (ou saída) textual do atalho.x-cancel — optional: um URL que se abre quando a interação é cancelada pela usuário.
x-error (opcional): um URL que se abre quando a interação falha porque ocorreu um erro. Um parâmetro chamado
errorMessage(mensagem de erro) é afixado ao URL, contendo uma descrição do erro.
Com o x-success, você pode fornecer um URL que se abre depois que o atalho termina de ser executado corretamente. Isso pode ser usado em conjunto com uma checklist de vários passos de tarefas, na qual você abre o x-callback-url para executar um atalho, retorna à lista e prossegue para a tarefa seguinte via URL.
Com o x-cancel, você pode fornecer um URL de contingência que se abre quando o atalho é interrompido antes de ser executado. Devido ao atalho não ter sido concluído, ele não fornece nenhum resultado.
Com o x-error, você pode fornecer um URL de contingência que se abre quando o atalho encontra um erro ao ser executado e não é concluído. Neste caso, você pode disparar um URL diferente para lidar com o problema.