![](https://help.apple.com/assets/62867F4BA154561AD42D0C98/62867F4EA154561AD42D0CA7/he_IL/389e356d55e928d40def9c16d476e5e0.png)
שימוש ב-x-callback-url ב״קיצורים״ ב-iPhone או ב-iPad
״קיצורים״ תומך ב-x-callback-url, וכך מאפשר ליישום שמתקשר לקבל תגובה (התקשרות חזרה) לאחר שאינטראקציה מסוימת הושלמה. ניתן להפעיל קיצורים מ-x-callback-url באמצעות אותם פרמטרים שנידונו בסעיף הפעלת קיצור באמצעות סכמת כתובת אינטרנט ב-iPhone או ב-iPad. לדוגמא:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
לפי סטנדרט ה-x-callback-url, ניתן לספק את הפרמטרים הנוספים הבאים:
x-success (לא חובה): כתובת אינטרנט שנפתחת כשהאינטראקציה מוצלחת - לדוגמה, לאחר שקיצור מיובא או מסיים לפעול. אם הקיצור פועל, פרמטר בשם
result
מתווסף לכתובת האינטרנט ומכיל את הפלט המילולי של הקיצור.x-cancel (לא חובה): כתובת אינטרנט שנפתחת כשהאינטראקציה מבוטלת על-ידי המשתמש/ת.
x-error (לא חובה): כתובת אינטרנט שנפתחת כשהאינטראקציה נכשלת עקב שגיאה. פרמטר בשם
errorMessage
מתווסף לכתובת האינטרנט ומכיל תיאור של השגיאה.
באמצעות x-success
, ניתן לספק כתובת אינטרנט שנפתחת אחרי שהקיצור מסיים פעולתו בהצלחה. ניתן להשתמש באפשרות זו בשילוב עם רשימה מרובת שלבים של מטלות לביצוע, שבה פותחים את x-callback-url להפעלת הקיצור, חוזרים לרשימה וממשיכים אל המטלה הבאה דרך כתובת אינטרנט.
באמצעות x-cancel
, ניתן לספק כתובת אינטרנט חלופית להפעלה אם הקיצור עוצר לפני שהוא מסיים את פעולתו. מאחר שהקיצור לא השלים את פעולתו, הוא לא סיפק פלט כלשהו.
באמצעות x-error
, ניתן לספק כתובת אינטרנט חלופית להפעלה אם הקיצור נתקל בשגיאה בעת הפעולה ואינו יכול לסיימה. במקרה זה, ניתן לפתוח כתובת אינטרנט אחרת על-מנת לטפל בבעיה.