Usar URL X-Callback con Atajos
Atajos es compatible con URL X-Callback, lo que permite a la app que llama recibir una respuesta (callback) cuando se completa una interacción particular. Puedes importar y ejecutar esquemas de una URL X-Callback usando los mismos parámetros que se han tratado en Ejecutar un atajo con un esquema de URL y Importar un atajo con un esquema de URL. A continuación se proporciona un ejemplo:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Para la URL X-Callback estándar, se pueden proporcionar los siguientes parámetros:
x-succes (opcional): Una URL que se abre cuando la interacción se realiza con éxito, por ejemplo, después de importar un atajo o terminar su ejecución. Si se ejecuta un atajo, un parámetro llamado
resultadose adjunta a la 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 porque se ha producido un error. Un parámetro llamado
errorMessagese adjunta a la URL y contiene una descripción del error.
Con x-success, puedes proporcionar una URL que se abra una vez que el atajo haya terminado de ejecutarse correctamente. Esto se podría usar en combinación con una lista de comprobación de tareas de varios pasos en OmniFocus, donde abres la URL X-Callback para ejecutar un atajo, volver a la lista y desplazarte hasta la siguiente tarea mediante una URL.
Con x-cancel, puedes proporcionar una URL de contingencia que se abre si el atajo se detiene antes de terminar de ejecutarse. Como el atajo no se ha completado, no se proporciona ningún resultado.
Con x-error, puedes proporcionar una URL de contingencia que se abre si el atajo detecta un error al ejecutarse y no termina su ejecución. En este caso, puedes iniciar una URL diferente para gestionar el problema.