שימוש ב-x-callback-url עם ״קיצורים״ ב-Mac
״קיצורים״ תומך ב-x-callback-url, וכך מאפשר ליישום שמתקשר לקבל תגובה (התקשרות חזרה) לאחר שאינטראקציה מסוימת הושלמה. ניתן להפעיל קיצורים מ-x-callback-url באמצעות אותם פרמטרים המתוארים בהפעלת קיצור באמצעות סכמת כתובת אינטרנט ב-Mac. לדוגמה:
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, ניתן לספק כתובת אינטרנט חלופית להפעלה אם הקיצור נתקל בשגיאה בעת הפעולה ואינו יכול לסיימה. במקרה זה, ניתן לפתוח כתובת אינטרנט אחרת על-מנת לטפל בבעיה.