Usar x-callback-url con Atajos en el iPhone o el iPad
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 ejecutar accesos desde una URL x-callback-url usando los mismos parámetros que se han tratado en Ejecutar un atajo con un esquema de URL en el iPhone o el iPad. Por ejemplo:
shortcuts://x-callback-url/run-shortcut?name=Calcular%20propina&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
result(resultado) se 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. En combinación con una lista de comprobación de tareas de varios pasos, abriría la URL x-callback-url 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 ninguna salida.
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.