![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D258BE0233D28263F5A/fi_FI/389e356d55e928d40def9c16d476e5e0.png)
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ä
result
lisä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ä
errorMessage
lisä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.