Verwenden einer X-Callback-URL in der App „Kurzbefehle“ auf iPhone oder iPad
Die App „Kurzbefehle“ unterstützt X-Callback-URLs, die es der aufrufenden App ermöglichen, eine Antwort (einen Callback) zu empfangen, nachdem eine bestimmte Interaktion abgeschlossen wurde. Du kannst Kurzbefehle mithilfe einer X-Callback-URL ausführen und dabei dieselben Parameter verwenden, die unter Ausführen eines Kurzbefehls mithilfe eines URL-Schemas auf iPhone oder iPad beschrieben sind. Zum Beispiel:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24,99&x-success=...&x-cancel=...
Gemäß dem Standard für X-Callback-URLs können die folgenden zusätzlichen Parameter bereitgestellt werden:
x-success (optional): Hiermit wird eine URL angegeben, die geöffnet wird, wenn eine Interaktion erfolgreich verlief, wenn zum Beispiel die Ausführung oder der Import eines Kurzbefehls beendet wurde. Beim Ausführen des Kurzbefehls wird der Parameter „
result“ an das Ende der URL angehängt; er enthält in Textform die Ausgabe des Kurzbefehls.x-cancel (optional): Hiermit wird eine URL angegeben, die geöffnet wird, wenn eine Interaktion von dem:der Benutzer:in abgebrochen wird.
x-error (optional): Hiermit wird eine URL angegeben, die geöffnet wird, wenn eine Interaktion wegen eines Fehlers scheitert. An die URL wird der Parameter „
errorMessage“ angehängt, der eine Beschreibung des Fehlers enthält.
Mit dem Parameter „x-success“ kannst du eine URL angeben, die geöffnet wird, wenn die Ausführung des Kurzbefehls erfolgreich beendet wurde. Diese Funktion könnte zusammen mit einer mehrstufigen Aufgabenliste genutzt werden, um über die X-Callback-URL einen Kurzbefehl auszuführen und danach zur Liste zurückzukehren, um die jeweils nächste Aufgabe über die URL auszuführen.
Mit dem Parameter „x-cancel“ kannst du eine URL angeben, die in dem Fall geöffnet wird, dass die Ausführung eines Kurzbefehls gestoppt wird, bevor dieser beendet wurde. Da der Kurzbefehl nicht bis zu Ende ausgeführt wird, stellt er keine Ausgabe bereit.
Mit dem Parameter „x-error“ kannst du eine URL angeben, die in dem Fall geöffnet wird, dass die Ausführung eines Kurzbefehls wegen eines Fehlers scheitert und nicht beendet werden kann. In diesem Fall kannst du eine andere URL öffnen, um das Problem zu beheben.