דלגו לתוכן
Wink

אימות

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

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

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

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

Staging

Section titled “Staging”
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>"

Production

Section titled “Production”
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} הכנס את אסימון הגישה שלך.

Scopes

Section titled “Scopes”

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

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

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

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

קבוצת ScopeScopesמה הם מפעיליםסיכון
חשבוןaccount.read account.write account.removeניהול ישויות, חברי צוות, הגדרות, אפליקציותנמוך–בינוני
מלאיinventory.read inventory.write inventory.removeנכסים, סוגי חדרים, תוכניות תעריפים, תעריפים, תוספות, זמינות, פעילויות, אטרקציותנמוך–בינוני
הזמנותbooking.read booking.write booking.removeחיפוש, צפייה, יצירה, ביטול והחזר הזמנות; תשלום; מדיניות ביטולנמוך–בינוני
שיווקmarketing.read marketing.write marketing.removeקמפיינים, הטבות, ערוצי מכירה, WinkLinks, ניהול רשתות חברתיות, נאמנותנמוך–בינוני
תוכן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נמוך–בינוני

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

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