Setup

מאמר זה מראה לכם כיצד להגדיר במהירות כמפתח ולהתחיל לבדוק את ממשקי ה-API שלנו ב-Wink.

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

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

בצע את השלבים הבאים:

1. לִרְשׁוֹם חשבון המשתמש שלך ב-Wink
2. צור חשבון סוכן נסיעות או חשבון שותפים.
3. צור יישום היכן שאתה מקשר אותו לחשבון שיצרת בשלב 2.
4. לאחר שיצרת את שלך Application, שמור את מזהה הלקוח ואת סוד הלקוח במקום בטוח.

CDN

ב-Wink, אנו משתמשים ב-Cloudinary עבור כל נכסי התמונות והווידאו שלנו. כשתיגשו למלאי הנסיעות שלנו, תהיה לכם גישה מלאה לכל התכונות המתקדמות של Cloudinary.

שלנוcloud_nameהואtraveliko.

קלאודינרי

• תחילת העבודה
• ערכות פיתוח תוכנה (SDK)
• קלאודינרי ב-GitHub
• הדרכות וידאו

דוּגמָה

עבור כל סוג של מלאי נסיעות שאנו תומכים בו, יהיה מערך JSON מקונן בשםmultimediasקובץ ה-JSON עבור ערך מולטימדיה נראה כך:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

השורה המודגשת למעלה מציגה את המזהה הייחודי של Cloudinarypartners/radisson_blu_logoזה כל מה שאתה צריך כדי לאחזר את התמונה בכל פורמט, איכות וגודל שתרצה.

בּוֹחֵן

לכו אלינוממשקי APIובחר את ה-API שברצונך לעבוד איתו.

מסמכי API

אתר התיעוד שלנו בנוי בצורה כזו שתוכלו להריץ פקודות API מתוך האתר.

בדוגמה זו, ברצונך להשתמש ב-Search Lookups (OAuth2)קריאה ל-API.

:::tip[טיפ מקצועי] לנוחות השימוש, אנו ממליצים לאינטגרטורים להשתמש בנקודות הקצה שאנו מציינים כOAuth2נקודות הקצה הללו יודעות לצפות לקוראי API וכבר יודעות באיזה חשבון אתה נמצא, כך שלא תצטרך לציין אתcompanyIdentifierבכתובות האתרים שלך. :::

1. השתמש ב ממשק API לחיפוש כדי לאחזר יעדים או מלונות.
2. בסרגל הניווט השמאלי, לחצו על Authentication.
3. הזן את מזהה הלקוח וסוד הלקוח שלך ולחץ על Get TOKEN לַחְצָן.
4. אם האישורים שלך תקפים, תראה שמפתח ה-API שלך הוחל.
5. כעת באפשרותך לבדוק את נקודת הקצה של החיפוש.

חיפושי דוגמה (OAuth2)

דוור

אפשר לעשות את אותו הדבר עם פוסטמן.

1. הורדה דוור.
2. לחץ על Download OpenAPI spec מהחלק העליון של ה- ממשק API לחיפוש עַמוּד.
3. ייבא את זה לפוסטמן.
4. אם ייבאת אותו כאוסף חדש בשם Wink API, לחצו על הסימן האופקי (3 נקודות) שליד שם האוסף ולחצו על Edit.
5. ב- Authorization tab, הגדר את Auth type ל-OAuth2.
6. הגדר את השדה Add auth data to אֶל Request headers.
7. הגדר את השדה Header prefix אֶל Bearer.
8. הגדר את השדה Token Name לאיזה שם שתרצו לתת לאסימון השמור שלכם בפוסטמן. לדוגמה, Wink Staging.
9. הגדר את השדה Grant type אֶל Client Credentials.
10. הגדר את השדה Access token URL אל https://staging-iam.wink.travel/oauth2/token.
11. הגדר את השדה Client ID למזהה הלקוח שהאפליקציה שלך עזרה ליצור.
12. הגדר את השדה Client Secret לסוד הלקוח שהאפליקציה שלך עזרה ליצור.
13. הגדר את השדה Scope אֶל inventory.read inventory.write inventory.removeאלו כל הטלסקופים שתצטרכו עבור Wink.
14. הגדר את השדה Client Authentication אֶל Send as Basic Auth header.
15. לחץ על ה Get New Access Token כפתור כדי לאחזר את האסימון שלך ולשמור אותו.
16. עבור כל קריאות ה-API תחת אוסף ה-API של Wink, ודא שבכרטיסיית האימות כתוב Inherit auth from parent אז זה כולל את האסימון שלך בכל שיחה.

:::tip[טיפ מקצועי] מומלץ להפוך את דומיין השרת, מזהה הלקוח וסוד הלקוח למשתני סביבה. כך תוכלו לעבור בקלות בין סביבות staging לסביבת ייצור ולעשות שימוש חוזר בכל הפעולות שיצרתם. :::