דלגו לתוכן

הגדרה

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

עקבו אחר השלבים הבאים:

  1. הרשמו לחשבון המשתמש שלכם ב-Wink.
  2. צרו חשבון שותף. תזדקקו לכך כדי לקשר אליו את האפליקציה שלכם. ראו מהי שיווק לקבלת הקשר נוסף.
  3. צרו אפליקציה וקשרו אותה לחשבון השותף שיצרתם בשלב 2. לאינטגרציות API מסוג שרת-לשרת, בחרו MACHINE_2_MACHINE כסוג הלקוח.
  4. לאחר שיצרתם את ה-Application, העתיקו ושמרו מיד את מזהה הלקוח והמפתח הסודי — המפתח הסודי מוצג רק פעם אחת ואינו ניתן לשחזור.

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

ה-cloud_name שלנו הוא traveliko.

לכל סוג מלאי נסיעות שאנו תומכים בו, יהיה מערך 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"
}
]
}

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

גשו לקטגוריית ה-APIs שלנו ובחרו את ה-API שברצונכם לעבוד איתו.

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

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

  1. השתמשו ב-Lookup API כדי לשלוף יעדים או מלונות.
  2. בסרגל הניווט השמאלי, לחצו על Authentication.
  3. הזינו את מזהה הלקוח והסוד של הלקוח ולחצו על כפתור Get TOKEN.
  4. אם האישורים שלכם תקינים, תראו שמפתח ה-API שלכם הוחל.
  5. כעת תוכלו לבדוק את נקודת הקצה של ה-lookup.
נקודת קצה של Lookup API
דוגמת Search Lookups (OAuth2)

ניתן לעשות את אותו הדבר עם Postman.

  1. הורידו את Postman.
  2. לחצו על Download OpenAPI spec בראש דף ה-Lookup API.
  3. ייבאו אותו ל-Postman.
  4. אם ייבאתם אותו כאוסף חדש בשם Wink API, לחצו על שלוש הנקודות האופקיות לצד שם האוסף ולחצו על Edit.
  5. בכרטיסיית Authorization, הגדירו את Auth type ל-OAuth2.
  6. הגדירו את השדה Add auth data to ל-Request headers.
  7. הגדירו את השדה Header prefix ל-Bearer.
  8. הגדירו את השדה Token Name לשם שתרצו לתת לטוקן השמור ב-Postman. לדוגמה: 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). ראו את רשימת הטווחים לקבלת הרשימה המלאה.
  14. הגדירו את השדה Client Authentication ל-Send as Basic Auth header.
  15. לחצו על כפתור Get New Access Token כדי לקבל את הטוקן ולשמור אותו.
  16. בכל קריאות ה-API תחת אוסף Wink API, ודאו שכרטיסיית האימות אומרת Inherit auth from parent כדי לכלול את הטוקן שלכם בכל קריאה.