Bruk x-callback-url med Snarveier
Snarveier støtter x-callback-url, som gjør det mulig for appen som ringer, å motta et svar (en callback) når en bestemt samhandling er fullført. Du kan importere og utføre snarveier fra en x-callback-url med de samme parameterne som omtalt i Utfør en snarvei ved hjelp av en URL-type og Importer en snarvei ved hjelp av en URL-type. Her er et eksempel:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
I henhold til x-callback-url-standarden kan følgende ytterligere parametere oppgis:
x-success (valgfritt): En URL som åpnes når samhandlingen er vellykket – for eksempel etter at en snarvei er importert eller ferdig med å utføre. Hvis en snarvei utføres, settes en parameter med navnet
resultinn ved slutten av URL-en, og inneholder snarveiens tekstutdata.x-cancel (valgfritt): En URL som åpnes når samhandlingen avbrytes av brukeren.
x-error (valgfritt): En URL som åpnes når samhandlingen mislykkes fordi det oppstod en feil. En parameter med navnet
errorMessagesettes inn ved slutten av URL-en og inneholder en beskrivelse av feilen.
Med x-success kan du angi en URL som åpner etter at snarveien er ferdig med å utføre. Dette kunne for eksempel brukes i sammenheng med en flertrinns sjekkliste med oppgaver i OmniFocus, der du åpner x-callback-url-en for å utføre en snarvei, går tilbake til listen, og går videre til neste oppgave via URL.
Med x-cancel kan du oppgi en reserve-URL som åpnes hvis snarveien stopper før den slutter å utføres. Fordi snarveien ikke fullførte, kommer det ingen utdata fra snarveien.
Med x-error kan du oppgi en reserve-URL som åpnes hvis snarveien feiler mens den utføres og ikke fullføres. I dette tilfellet kan du starte en annen URL for å håndtere problemet.