Utiliser x-callback-url avec Raccourcis sur l’iPhone ou l’iPad
Raccourcis prend en charge x-callback-url, permettant à l’application appelante de recevoir une réponse (un rappel ou « callback » en anglais) lorsqu’une interaction particulière prend fin. Vous pouvez exécuter des raccourcis à partir d’un x-callback-url en utilisant les mêmes paramètres, tel qu’expliqué dans la rubrique Exécuter un raccourci à l’aide d’un schéma d’URL sur l’iPhone ou l’iPad. Par exemple :
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Selon la norme x-callback-url, les paramètres supplémentaires suivants peuvent être définis :
x-success (facultatif) : Une URL qui s’ouvre lorsque l’interaction est réussie, par exemple, après l’importation ou la fin de l’exécution d’un raccourci. Si un raccourci est exécuté, un paramètre du nom de
result(résultat) est ajouté à l’URL et contient la sortie textuelle du raccourci.x-cancel (facultatif) : Une URL qui s’ouvre lorsque l’interaction est annulée par l’utilisateur.
x-error (facultatif) : Une URL qui s’ouvre lorsque l’interaction échoue, parce qu’une erreur s’est produite. Un paramètre du nom de
errorMessage(message d’erreur) est ajouté à l’URL et contient une description de l’erreur.
Avec x-success, vous pouvez spécifier une URL qui s’ouvre, après l’exécution du raccourci. Ceci pourrait être utilisé en association avec une liste de pointage de tâches en plusieurs étapes, dans laquelle vous ouvrez x-callback-url pour exécuter un raccourci, retourner à la liste et passer à la tâche suivante par le biais de l’URL.
Avec x-cancel, vous pouvez spécifier une URL de contingence qui se lancera si le raccourci s’arrête avant la fin de son exécution. Le raccourci ne s’étant pas exécuté jusqu’au bout, il ne donne aucun résultat.
Avec x-error, vous pouvez spécifier une URL de contingence qui se lancera si le raccourci rencontre une erreur en cours d’exécution et ne s’arrête avant la fin. Dans ce cas, vous pouvez lancer une URL différente pour traiter le problème.