開始使用 API
欲使用 Expedia Group 平台 API,您必須建立一個或多個 API 客戶端。API 客戶端就像一個使用密碼保護的使用者帳戶,基本上,它確認了傳送 API 請求的軟體屬於您 (身分驗證),並允許您限制每個客戶端能夠傳送的 API 請求類型 (授權)。
建立 API 客戶端
您可以在控制台建立及管理您的 API 客戶端。
步驟:
- 登入現有的帳戶,或設置一個新的使用者帳戶並提供與您業務相關所需的基本資訊
- (選用) 建立一個新的測試用合作夥伴帳戶
- 選取並配置您想要使用的產品
- 請求 API 客戶端 (使用左下角的「+」圖標)
您能夠依據需求建立需要數量的 API 客戶端。每個客戶端都能夠被授予特定權限,賦予您限制每個軟體服務在 Expedia Group 平台上的使用範圍。
選取產品與使用範圍
所有 API 客戶端皆在同一個合作夥伴帳戶中執行。您能夠在單一合作夥伴帳戶下選擇及設定多項產品,所有設定的產品都將在您建立新客戶端時列出。您能夠建立單一 API 客戶端,並授予其在合作夥伴帳戶中一項或多項產品的存取權。
每項產品皆定義出一組「使用範圍」,授予對某些請求類型的存取權。您為 API 客戶端設定的使用範圍,限制客戶端被授權執行的操作。若有多項軟體服務傳送 API 請求,請為每項服務建立一個單獨的 API 客戶端,並僅選擇每個 API 客戶端需要的使用範圍。
複製客戶端登入資訊
每個 API 客戶端都擁有一個金鑰與一組用於身分驗證的密鑰,與使用者名稱及密碼相似。登入資訊僅在建立客戶端時顯示,因此您務必在繼續下一步前複製並儲存。
請務必妥善保存您的 API 客戶端登入資訊!請勿將您的客戶端帳號或密碼儲存在如 GitHub、客戶端代碼等可公開存取的區域。
開始探索!
若您只想在 API Explorer 中試用 API,您可以立即開始。可以使用「授權」按鈕直接在 API Explorer UI 中輸入 API 客戶端金鑰 (client_id) 與密鑰。
欲了解如何在您的軟體中內嵌 API 客戶端,請閱讀下一章節。