x-callback-urlin käyttäminen iPhonen tai iPadin Pikakomennoissa
Pikakomennot tukee x-callback-urlia, jonka avulla kutsuva appi voi saada palautteen (takaisinkutsu), kun tietty vuorovaikutus on päättynyt. Voit suorittaa pikakomentoja x-callback-urlin avulla käyttämällä samoja parametreja, joista kerrotaan kohdassa Pikakomennon suorittaminen iPhonessa tai iPadissa URL-rakennetta käyttämällä. Esimerkiksi:
shortcuts://x-callback-url/run-shortcut?name=Laske%20tippi&input=text&text=24.99&x-success=...&x-cancel=...
X-callback-url-standardin mukaisesti voidaan käyttää seuraavia lisäparametreja:
x-success (valinnainen): URL, joka avautuu, jos vuorovaikutus onnistuu – esimerkiksi sen jälkeen, kun pikakomento on tuotu tai suoritettu. Jos pikakomento on suoritettu, parametri nimeltä
resultlisätään URLiin, ja se sisältää pikakomennon tekstituotoksen.x-cancel (valinnainen): URL, joka avautuu, jos käyttäjä peruuttaa vuorovaikutuksen.
x-error (valinnainen): URL, joka avautuu, kun vuorovaikutus epäonnistuu virheen takia. Parametri nimeltä
errorMessagelisätään URLiin, ja se sisältää virheen kuvauksen.
Lisäparametrilla x-success voit antaa URLin, joka avautuu sen jälkeen, kun pikakomento on onnistuneesti suoritettu. Voit käyttää tätä monivaiheisen tarkistuslistan yhteydessä siten, että avaat x-callback-urlin pikakomennon suorittamista varten, palaat listaan ja siirryt sen seuraavaan kohtaan URLin kautta.
Lisäparametrilla x-cancel voit antaa vara-URLin, joka käynnistetään, jos pikakomento pysähtyy ennen loppuun suorittamista. Koska pikakomento keskeytyi, se ei anna mitään tuotosta.
Lisäparametrilla x-error voit antaa vara-URLin, joka käynnistetään, jos pikakomennossa tapahtuu virhe suorituksen aikana eikä sitä voida suorittaa loppuun. Tässä tapauksessa voit käynnistää toisen URLin, joka käsittelee ongelman.