אפליקציות
אפליקציות מעניקות לך גישה לכל התכונות של Wink כמפתח. תוכל לגשת לכל אותם נתונים ואפילו להרחיב את התכונות של Wink. אתה יכול לבחור להשתמש בשרת OAuth2 של Wink כדי לאמת את אתר הנסיעות שלך באותה דרך שבה היית משתמש בגוגל או בפייסבוק. כך תוכל להרחיב את תכונות Wink לאתר או לאפליקציה שלך.
- בחר את החשבון שברצונך לעבוד איתו מתוך חשבונות.
- לחץ על
Actionsבתחתית כרטיס החשבון ובחר ב-Manage account. - לחץ על לשונית
Applicationsבעמוד הבא. - בחלק זה יופיעו כל האפליקציות שלך.
- סובב או מחק אפליקציה קיימת, או צור חדשה.
יצירת אפליקציה
Section titled “יצירת אפליקציה”מכיוון שאינך יכול לגשת לsecret key של האפליקציה שיצרנו עבורך, תצטרך ליצור אחת משלך.
ניתן ליצור אפליקציה כאן מבלי להגדיר קודם נכס או חברה — היא אינה קשורה
לחשבון ספציפי כלשהו.
סוגי לקוחות
Section titled “סוגי לקוחות”בעת יצירת אפליקציה, בוחרים סוג לקוח שקובע כיצד האפליקציה מאמתת את עצמה. לא ניתן לשנות זאת מאוחר יותר — אם אתה צריך סוג אחר, צור אפליקציה חדשה.
- אפליקציית ווב — אפליקציה שמופעלת בשרת ויכולה לשמור סוד לקוח בבטחה (authorization code flow).
- אפליקציית דף יחיד (SPA) — אפליקציה בדפדפן ללא backend; משתמשת ב-PKCE, ללא סוד לקוח.
- אפליקציית מובייל — אפליקציה מקומית ל-iOS/Android; משתמשת ב-PKCE עם טוקני רענון מסתובבים.
- מכונה למכונה — שירות backend הפועל בשם עצמו (client credentials); ללא כניסת משתמש.
הנה השלבים ליצירת אפליקציה:
- בדף האפליקציות, לחץ על כפתור
Create new application. - שם תן שם לאפליקציה שלך. למשל Cool App
- סוג לקוח בחר את הסוג שמתאים לאופן האימות של האפליקציה — ראה סוגי לקוחות למעלה.
- Redirect URIs נדרש לפחות URI אחד להפניה מחדש. הוא משמש לאימות דומיין ההפניה לאחר אימות מוצלח. לא בשימוש באפליקציות מכונה למכונה. למשל https://www.cool-site.com
- Post-logout redirect URIs (אופציונלי) כתובות URL שאליהן המשתמשים יכולים להיות מנותבים לאחר התנתקות. השאר ריק כדי להשתמש שוב ב-redirect URIs שלמעלה.
- Scopes בחר מה האפליקציה הזו יכולה לגשת בשמך — ראה בחירת scopes למטה.
- לחץ על כפתור
Create applicationכדי להמשיך.
אתה מנותב חזרה לרשימת האפליקציות שלך, ודיאלוג חד-פעמי מציג את Client ID וה-Client secret החדשים. העתק את הסוד עכשיו ושמור אותו במקום בטוח — הוא לעולם לא יוצג שוב, ואין דרך לשחזר אותו מאוחר יותר (רק לסובב אותו לאחד חדש).
בחירת scopes
Section titled “בחירת scopes”כל אפליקציה תמיד נושאת את scopes של Sign-in (OpenID Connect) (openid, profile,
email, offline_access) — אלו מאשרים את זהות המשתמש ושומרים אותו מחובר, ולכן הם
מסומנים ומנעולים; הם אינם בחירה.
כל השאר הם אופציונליים. ה-scopes הנותרים מקובצים לאותם חלקים פונקציונליים
שמתועדים ב-Scopes — חשבון, מלאי ותעריפים, הזמנות,
שיווק וקידומים, תוכן נכס, אנליטיקה ודוחות, אינטגרציות מנהל ערוצים,
תשלומים, וחשבונאות וספרים — כל אחד עם תיאור בשפה פשוטה של מה שהוא מאפשר. השתמש
בקישורי All / None מעל הרשימה כדי לבחור או לנקות את כל ה-scopes האופציונליים בבת אחת.
שתי משפחות scopes אינן מוצעות בכוונה בטופס זה:
mcp.*— גישה של סוכן AI לModel Context Protocol. אינך יוצר אפליקציה עבורו: לקוח AI כמו Claude, ChatGPT או Codex רושם את עצמו ומבקש scopes אלו כאשר אתה נכנס דרך מסך ההסכמה של MCP. הם לעולם לא ניתנים לאפליקציות מכונה למכונה, כי MCP תמיד פועל בשם משתמש מחובר.- Scopes ברמת מנהל (
administrator.*) — גישה ברמת הפלטפורמה שאינה ניתנת לכל אפליקציה.
לאחר יצירת אפליקציה, גם לשונית זו וגם אפליקציות עם הסכמה מציגות את ה-scopes שהוענקו לה
מקובצים לפי חלק (למשל “הזמנות: booking.read”), כך שתוכל לראות במהירות מה האפליקציה יכולה לעשות מבלי לפתוח אותה.
סיבוב אישורים
Section titled “סיבוב אישורים”אם סוד הלקוח עלול היה להדלף, או אם אתה רוצה אישורים חדשים, סובב אותם במקום ליצור את האפליקציה מחדש:
- מצא את האפליקציה ברשימת האפליקציות שלך ולחץ על
Rotate. - אשר את הדיאלוג — ה-Client ID והסוד הנוכחיים מפסיקים לעבוד מיד.
- העתק את ה-Client ID והסוד החדשים מהדיאלוג החד-פעמי לפני סגירתו.
סיבוב שומר על שם האפליקציה, סוג הלקוח, ה-redirect URIs וה-scopes — רק האישורים משתנים.
הסרת אפליקציה
Section titled “הסרת אפליקציה”אם אין לך צורך נוסף באפליקציה, תוכל להסיר אותה. זה קבוע — האישורים מבוטלים מיד ואינם ניתנים לשחזור.
- מצא את האפליקציה ברשימת האפליקציות שלך ולחץ על
Delete. - אשר את הדיאלוג למחיקה קבועה של האפליקציה.
