Bruk x-callback-url med Snarveier på Mac
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 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 på Mac. For 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
result
inn 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
errorMessage
settes 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 kan for eksempel brukes i sammenheng med en flertrinns sjekkliste med oppgaver, 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.