Utilizzare l'azione x-callback-url su iPhone o iPad
Comandi Rapidi supporta l'azione x-callback-url, consentendo all'app che sta chiamando di ricevere una risposta (una richiamata) quando un'interazione specifica è completa. Puoi eseguire un comando da un x-callback-url utilizzando i medesimi parametri indicati in Eseguire un comando rapido usando uno schema URL su iPhone o iPad. Ad esempio:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Per lo standard x-callback-url, possono essere forniti i seguenti parametri aggiuntivi:
x-success (facoltativo): Un URL che si apre quando l'interazione va a buon fine, ad esempio, dopo l'importazione o il termine dell'esecuzione di un comando rapido. Se viene eseguito un comando rapido, un parametro chiamato
resultviene aggiunto all'URL e contiene l'output testuale del comando rapido.x-cancel (facoltativo): Un URL che si apre quando l'interazione viene cancellata dall'utente.
x-error (facoltativo): Un URL che si apre quando l'interazione fallisce a causa di un errore. Viene aggiunto all'URL un parametro chiamato
errorMessageche contiene una descrizione dell'errore.
Con x-success, puoi fornire un URL che si apre dopo che il comando rapido termina l'esecuzione corretta. L'opzione può essere usata in concomitanza con un elenco di verifica di azioni con più passi, in cui apri x-callback-url per eseguire un comando rapido, tornare all'elenco e passare all'attività successiva tramite l'URL.
Con x-cancel, puoi fornire un URL di contingenza da lanciare nel caso in cui il comando rapido si interrompa prima di terminare l'esecuzione. Siccome il comando rapido non è stato completato, non viene fornito alcun output per il comando rapido.
Con x-error, puoi fornire un URL di contingenza da lanciare nel caso in cui il comando rapido trovi un errore durante l'esecuzione e non la porti a termine. In questo caso, puoi lanciare un URL diverso per gestire il problema.