דלגו לתוכן

אימות

אפליקציה מספקת לך Client ID ו-Secret Key שעליך להשתמש בהם כדי ליצור סשן OAuth2 מאומת שתוכל להשתמש בו לתקשורת עם ממשקי ה-API של Wink ו-TripPay.

להלן השלבים ליצירת סשן מאומת.

שלב 1. קבל אסימון גישה בסביבת הבדיקה או בסביבת הייצור שלנו:

סביר להניח שתעבוד עם ספריית OAuth2 חזקה לשפת התכנות שלך, שתבצע את כל העבודה הכבדה עבורך. הדוגמאות שלנו יציגו שימוש בסיסי ביותר משורת הפקודה באמצעות curl.

Terminal window
curl -X POST https://staging-iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_SECRET_KEY>"
Terminal window
curl -X POST https://iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_SECRET_KEY>"

זה יחזיר אסימון גישה, יחד עם נתוני תגובה נוספים של OAuth2:

{
"access_token": "abc123"
}

כאשר אתה מבצע קריאה לכל אחת מנקודות הקצה שלנו, כלול את הדברים הבאים בכותרת:

  • Wink-Version = 2.0 העדכני ביותר - ראה את תיעוד ה-API שלנו לגרסאות נוספות זמינות.
  • Authorization = Bearer ${access_token} הכנס את אסימון הגישה שלך.

Scope הוא הרשאה שנושאת אסימון הגישה שלך. כאשר אתה מבקש אסימון, אתה מעביר רשימת תחומי גישה מופרדת ברווח בפרמטר scope, והאסימון יכול לגשת רק לאזורים שהתחומים הללו מכסים. עם הרשאת client_credentials אתה מגדיר את התחומים בבקשת האסימון שלך — ראה את דוגמאות curl למעלה ואת המדריך של Postman.

תחומי הגישה נקראים section.action, כאשר הפעולה היא אחת מהבאות:

  • read — צפייה במשאבים (בקשות GET בטוחות)
  • write — יצירה ועדכון משאבים (POST / PUT / PATCH)
  • remove — מחיקת משאבים (DELETE)

Wink מארגנת הרשאות לפי תחום פונקציונלי. בקש רק את התחומים שהאינטגרציה שלך צריכה:

קבוצת תחומיםתחומיםמה הם מפעיליםסיכון
חשבוןaccount.read account.write account.removeניהול ישויות, חברי צוות, הגדרות, אפליקציותנמוך–בינוני
מלאיinventory.read inventory.write inventory.removeנכסים, סוגי חדרים, תוכניות תעריפים, תעריפים, תוספות, זמינות, פעילויות, אטרקציותנמוך–בינוני
הזמנותbooking.read booking.write booking.removeחיפוש, צפייה, יצירה, ביטול והחזר הזמנות; תשלום; מדיניות ביטולנמוך–בינוני
שיווקmarketing.read marketing.write marketing.removeקמפיינים, הטבות, ערוצי מכירה, מנהל קישורים, ניהול רשתות חברתיות, נאמנותנמוך–בינוני
תוכןcontent.read content.write content.removeתיאורי נכסים, ביקורות, מדיה, מפות, מדד ירוקנמוך–בינוני
אנליטיקהanalytics.read analytics.write analytics.removeדוחות וניתוחים — הכנסות, לוחות מוביליםנמוך–בינוני
אינטגרציותintegrations.read integrations.write integrations.removeמנהלי ערוצים, מערכות הזמנות חיצוניות, Google Hotel, נקודות התראה, סינכרון הזמנותנמוך–בינוני
תשלוםpayment.read payment.write payment.removeעיבוד תשלומים, Stripe, Revolut, תשלומים, מנוייםבינוני–גבוה
חשבונאותaccounting.read accounting.write accounting.removeחשבונאות, רישום משיכות, התאמותבינוני–גבוה
MCPmcp.read mcp.write mcp.removeפותח את MCP transport (/mcp) לסוכני AIנמוך–בינוני

כמה דברים שכדאי לזכור:

  • בקש את המינימום. בקש רק את התחומים שהאינטגרציה שלך באמת משתמשת בהם — אסימון עם גישה רחבה יותר מהנדרש הוא פוטנציאל נזק גדול יותר במקרה של דליפה.
  • תחומים לא מוכרים נדחים. בקשה לתחום שהאפליקציה שלך לא רשומה אליו, או שאינו קיים, תיכשל בעת הנפקת האסימון.
  • mcp.* מיועד רק ללקוחות סוכני AI. אתה צריך אותו כדי לפתוח את ה-MCP transport; הוא אינו נדרש לקריאות REST API רגילות. ראה Model Context Protocol.