
Usar x-callback-url com a aplicação Atalhos no Mac
A aplicação atalhos suporta x-callback-url, que permite a chamada da aplicação para receber uma resposta (uma chamada de resposta) quando uma interação especĆfica Ć© concluĆda. Pode importar e executar atalhos num xācallbackāurl atravĆ©s dos mesmos parĆ¢metros, conforme abordado em Executar um atalho atravĆ©s de um esquema de URL no Mac. Por exemplo:
shortcuts://x-callback-url/run-shortcut?name=Calcular%20gorjeta&input=text&text=24.99&x-success=...&x-cancel=...
De acordo com a norma x-callback-url, podem ser fornecidos os seguintes parâmetros adicionais:
x-success (opcional): um URL que se abre quando a interação Ć© bem-sucedida ā por exemplo, depois de um atalho ser importado ou terminar de ser executado. Se um atalho for executado, Ć© anexado ao URL um parĆ¢metro com o nome
result
que contém a entrada textual do atalho.x-cancel (opcional): um URL que se abre quando a interação é cancelada pelo utilizador.
x-error (opcional): um URL que se abre quando a interação falha devido à ocorrência de um erro. à anexado ao URL um parâmetro com o nome
errorMessage
que contém ma descrição do erro.
Com x-success
, pode fornecer um URL que se abre depois de o atalho concluir a execução com êxito. Isto poderia ser usado em conjunto com uma lista de verificação por vÔrias etapas de tarefas, onde abre o x-callback-url para executar um atalho, volta à lista e passa à tarefa seguinte através do URL.
Com x-cancel
, pode fornecer um URL de contingĆŖncia Ć© iniciado se o atalho parar antes de concluir a execução. Visto que o atalho nĆ£o foi concluĆdo, nĆ£o Ć© fornecida nenhuma saĆda do atalho.
Com x-error
, pode fornecer um URL de contingĆŖncia Ć© iniciado se o atalho encontrar um erro durante a execução e nĆ£o for concluĆdo. Neste caso, pode iniciar outro URL para resolver o problema.