Usar x-callback-url con Shortcuts
Atajos permite el uso de x-callback-url, de modo que la app de llamadas puede recibir una respuesta (una llamada de respuesta) cuando se ha completado una interacción específica. Puedes importar y ejecutar atajos desde una x-callback-url utilizando los mismos parámetros de la sección Ejecutar un atajo utilizando un esquema URL y Importar un atajo utilizando un esquema URL. Por ejemplo:
shortcuts://x-callback-url/run-shortcut?name=Calcular%20Propina&input=texto&texto=24.99&x-success=...&x-cancel=...
De acuerdo con el estándar x-callback-url, puedes proporcionar los siguientes parámetros adicionales:
x-success (opcional): una URL que se abre cuando la interacción se completa correctamente, por ejemplo, después de importar un atajo o después de ejecutarlo. Si se ejecuta un atajo, un parámetro llamado
resultadose agrega al final de la dirección URL y contiene la salida textual del atajo.x-cancel (opcional): una URL que se abre cuando el usuario cancela la interacción.
x-error (opcional): una URL que se abre cuando la interacción falla debido a un error. Al final de la URL se agrega un parámetro llamado
errorMessageque contiene una descripción del error.
Con x-success, puedes proporcionar una URL que se abre después de que el atajo termina de ejecutarse correctamente. Se puede usar en conjunto con una lista de verificación de tareas de varios pasos en OmniFocus, donde se abre la x-callback-url para ejecutar un atajo, regresa a la lista y avanza a la tarea siguiente mediante URL.
Con x-cancel, puedes proporcionar una URL aleatoria para abrirla si el atajo se detiene antes de completar la ejecución. Dado que el atajo no completa, no se proporciona una salida.
Con x-error, puedes proporcionar una URL aleatoria para abrirla si ocurre un error en el atajo mientras se ejecuta y no logra completar la ejecución. En este caso, puedes abrir una URL distinta para contrarrestar el problema.