x-callback-URL gebruiken met Opdrachten
Opdrachten ondersteunt x-callback-URL, waarmee de aanroepende app een respons (een "callback") kan ontvangen wanneer een bepaalde interactie is voltooid. Je kunt voor het uitvoeren van opdrachten uit een x-callback-URL de parameters gebruiken die worden beschreven in Een opdracht uitvoeren met een URL-schema. Bijvoorbeeld:
shortcuts://x-callback-url/run-shortcut?name=Bereken%20fooi&input=text&text=24.99&x-success=...&x-cancel=...
Overeenkomstig de standaard voor x-callback-URL kunnen de volgende extra parameters worden opgegeven:
x-success (optioneel): Een URL die wordt geopend wanneer de interactie is gelukt, bijvoorbeeld nadat een opdracht is geïmporteerd of uitgevoerd. Als een opdracht wordt uitgevoerd, wordt aan het einde van de URL een parameter met de naam
resulttoegevoegd, die de tekstuele uitvoer van de opdracht bevat.x-cancel (optioneel): Een URL die wordt geopend wanneer de interactie door de gebruiker wordt geannuleerd.
x-error (optioneel): Een URL die wordt geopend wanneer de interactie mislukt vanwege een fout. Aan het einde van de URL wordt een parameter met de naam
errorMessagetoegevoegd, die een beschrijving van de fout bevat.
Met x-success kun je een alternatieve URL opgeven die wordt geopend nadat de opdracht met succes is voltooid. Je kunt deze parameter gebruiken in combinatie met een uit meerdere stappen bestaande takenchecklist in OmniFocus, waarin je de x-callback-URL opent om een opdracht uit te voeren, terug naar de lijst te gaan en via de URL verder te gaan met de volgende taak.
Met x-cancel kun je een alternatieve URL opgeven die moet worden uitgevoerd als de opdracht voortijdig wordt beëindigd. Aangezien de opdracht niet is voltooid, wordt er ook geen uitvoer uit de opdracht aangeboden.
Met x-error kun je een URL opgeven die moet worden uitgevoerd als de opdracht wordt beëindigd vanwege een fout. In dit geval kun je een andere URL starten om de fout af te handelen.