Setup
本文向您展示如何快速成為開發人員並開始在 Wink 上測試我們的 API。
:::筆記 測試應該始終在我們的暫存環境。那裡的數據少得多,但您可以自由地進行盡可能多的測試,而不會對生產環境造成影響。
一旦您準備好上線,我們將認證您的帳戶和應用程序,然後您就可以在我們的生產環境中啟動。 :::
請依照以下步驟操作:
- 登記 您在 Wink 上的使用者帳戶
- 創建一個 旅行社帳戶 或 聯盟帳戶。
- 創建應用程式 將其與您在步驟 2 中建立的帳戶關聯起來。
- 一旦你創建了你的
Application
,將client-id和client secret保存在安全的地方。
在 Wink,我們使用 Cloudinary 來儲存所有影像和影片資產。當您造訪我們的旅遊庫存時,您將可以完全存取 Cloudinary 的所有進階功能。
我們的cloud_name
是traveliko
。
Cloudinary
Section titled “Cloudinary”對於我們支援的每種旅行庫存類型,都會有一個名為的巢狀 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 的唯一 IDpartners/radisson_blu_logo
。這就是您需要以任何格式、品質和大小檢索影像的全部內容。
前往我們的蜜蜂 部分並選擇您想要使用的 API。
API 文件
Section titled “API 文件”我們的文件網站設定方式使得您可以從網站內部執行 API 命令。
在這個例子中,你會想使用Search Lookups (OAuth2)
API 呼叫。
:::tip[專業提示]
為了方便使用,我們建議整合商使用我們指定的端點OAuth2
。這些端點知道預期的 API 呼叫者,並且已經知道你使用的帳戶,因此你不必指定companyIdentifier
在您的 URL 中。
:::
- 使用 尋找 API 檢索目的地或飯店。
- 在左側導覽列中,點擊
Authentication
。 - 輸入您的客戶端 ID 和客戶端金鑰,然後按一下
Get TOKEN
按鈕。 - 如果您的憑證有效,您將看到您的 API 金鑰已被套用。
- 現在您可以測試查找端點。
您可以使用 Postman 做同樣的事情。
- 下載 郵差。
- 點選
Download OpenAPI spec
從頂部 尋找 API 頁。 - 將其導入 Postman。
- 如果您將其匯入為名為
Wink API
,按一下集合名稱旁的水平省略號(3 個點),然後按一下Edit
。 - 在
Authorization tab
,設定Auth type
到 OAuth2。 - 設定字段
Add auth data to
到Request headers
。 - 設定字段
Header prefix
到Bearer
。 - 設定字段
Token Name
您可以在 Postman 中為已儲存的令牌命名。例如。眨眼登台。 - 設定字段
Grant type
到Client Credentials
。 - 設定字段
Access token URL
到 https://staging-iam.wink.travel/oauth2/token。 - 設定字段
Client ID
您的應用程式幫助產生的客戶端 ID。 - 設定字段
Client Secret
您的應用程式可協助產生的客戶端密鑰。 - 設定字段
Scope
到inventory.read inventory.write inventory.remove
。這些就是 Wink 所需的全部範圍。 - 設定字段
Client Authentication
到Send as Basic Auth header
。 - 點選
Get New Access Token
按鈕來檢索您的令牌並保存它。 - 對於 Wink API 集合下的所有 API 呼叫,請確保身份驗證標籤顯示
Inherit auth from parent
因此每次調用時都會包含您的令牌。
:::tip[專業提示] 建議將伺服器網域、客戶端ID和客戶端金鑰放入環境變數中。這樣,您可以輕鬆地在暫存環境和生產環境之間切換並重新使用您建立的所有操作。 :::