Χρήση x-callback-url με τις Συντομεύσεις σε iPhone ή iPad
Οι Συντομεύσεις υποστηρίζουν το x-callback-url, που επιτρέπει στην καλούσα εφαρμογή να λαμβάνει μια απάντηση (μια επιστροφή κλήσης) όταν ολοκληρώνεται μια συγκεκριμένη αλληλεπίδραση. Μπορείτε να εκτελείτε συντομεύσεις από ένα x-callback-url χρησιμοποιώντας τις ίδιες παραμέτρους που περιγράφονται στην ενότητα Εκτέλεση συντόμευσης με χρήση σχήματος URL σε iPhone ή iPad. Για παράδειγμα:
shortcuts://x-callback-url/run-shortcut?name=Calculate Tip&input=text&text=24.99&x-success=...&x-cancel=...
Σύμφωνα με το πρότυπο x-callback-url, μπορούν να δοθούν οι ακόλουθες επιπλέον παράμετροι:
x-success (προαιρετική): Μια διεύθυνση URL που ανοίγει όταν η αλληλεπίδραση είναι επιτυχής –για παράδειγμα, μετά την εισαγωγή ή την ολοκλήρωση μιας συντόμευσης. Αν εκτελεστεί μια συντόμευση, στη διεύθυνση URL προσαρτάται μια παράμετρος με όνομα
resultπου περιέχει την έξοδο κειμένου της συντόμευσης.x-cancel (προαιρετική): Μια διεύθυνση URL που ανοίγει όταν ακυρώνεται η αλληλεπίδραση από τον χρήστη.
x-error (προαιρετική): Μια διεύθυνση URL που ανοίγει όταν αποτυγχάνει η αλληλεπίδραση λόγω σφάλματος που προέκυψε. Στη διεύθυνση URL προσαρτάται μια παράμετρος με όνομα
errorMessageπου περιέχει μια περιγραφή του σφάλματος.
Με την x-success, μπορείτε να καθορίσετε μια διεύθυνση URL που θα ανοίγει μετά την επιτυχή ολοκλήρωση της συντόμευσης. Αυτή μπορεί να χρησιμοποιηθεί σε συνδυασμό με μια λίστα ελέγχου εργασιών πολλών βημάτων, όπου ανοίγετε το x-callback-url για να εκτελέσετε μια συντόμευση, να επιστρέψετε στη λίστα, και να περάσετε στην επόμενη εργασία μέσω URL.
Με την x-cancel, μπορείτε να καθορίσετε μια διεύθυνση URL έκτακτης ανάγκης που θα ανοίγει αν η συντόμευση διακοπεί πριν ολοκληρωθεί. Επειδή η συντόμευση δεν ολοκληρώνεται, δεν παρέχεται καμία έξοδος από τη συντόμευση.
Με την x-error, μπορείτε να καθορίσετε μια διεύθυνση URL έκτακτης ανάγκης που θα ανοίγει αν η συντόμευση συναντήσει κάποιο σφάλμα κατά την εκτέλεση και δεν καταφέρει να ολοκληρωθεί. Σε αυτήν την περίπτωση, μπορείτε να ορίσετε το άνοιγμα μιας διαφορετικής διεύθυνσης URL για τον χειρισμό του θέματος.