設定

本文說明如何快速以開發者身份設定並開始在 Wink 上測試我們的 API。

請依照以下步驟操作：

在 Wink 上註冊您的使用者帳戶。
建立聯盟帳戶。您需要此帳戶來綁定您的應用程式。更多背景請參考什麼是 Studio。
建立應用程式，並將其與您在步驟 2 建立的聯盟帳戶關聯。若為伺服器對伺服器的 API 整合，請選擇 MACHINE_2_MACHINE 作為客戶端類型。
建立 Application 後，請立即複製並保存 client-id 和 secret key — secret key 只會顯示一次，無法再次取得。

CDN

在 Wink，我們使用 Cloudinary 管理所有圖片和影片資產。當您存取我們的旅遊庫存時，將可完整使用 Cloudinary 的所有進階功能。

我們的 cloud_name 是 traveliko。

Cloudinary

範例

對於我們支援的每種旅遊庫存類型，都會有一個名為 multimedias 的巢狀 JSON 陣列。多媒體項目的 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 唯一 ID partners/radisson_blu_logo。這就是您取得該圖片任意格式、品質與尺寸的全部資訊。

測試

請前往我們的 API 區域，選擇您想使用的 API。

API 文件

我們的文件網站設計成可直接在網站內執行 API 指令。

本例中，您將使用 Search Lookups (OAuth2) API 呼叫。

使用 Lookup API 取得目的地或飯店資料。
在左側導覽列點選 Authentication。
輸入您的 client-id 和 client secret，然後點擊 Get TOKEN 按鈕。
若您的憑證有效，系統會顯示您的 API 金鑰已套用。
您現在可以測試 lookup 端點。

Lookup API endpoint — *Search Lookups (OAuth2) 範例*

Postman

您也可以使用 Postman 進行相同操作。

下載 Postman。
在 Lookup API 頁面頂端點擊 Download OpenAPI spec。
將其匯入 Postman。
若匯入為名為 Wink API 的新集合，點擊集合名稱旁的橫向省略符號（三點），選擇 Edit。
在 Authorization 標籤中，將 Auth type 設為 OAuth2。
將 Add auth data to 設為 Request headers。
將 Header prefix 設為 Bearer。
將 Token Name 設為您想在 Postman 中保存的令牌名稱，例如 Wink Staging。
將 Grant type 設為 Client Credentials。
將 Access token URL 設為 https://staging-iam.wink.travel/oauth2/token。
將 Client ID 設為您的應用程式所產生的 Client ID。
將 Client Secret 設為您的應用程式所產生的 Client Secret。
將 Scope 設為您的整合所需的空格分隔範圍（例如 inventory.read inventory.write inventory.remove）。完整清單請參考範圍參考。
將 Client Authentication 設為 Send as Basic Auth header。
點擊 Get New Access Token 按鈕以取得並保存令牌。
在 Wink API 集合下的所有 API 呼叫中，確保認證標籤顯示 Inherit auth from parent，以便每次呼叫都包含您的令牌。