開始使用 Rapid API

您可以自行架設 Rapid API，或與經認證的 third-party 合作夥伴攜手，推出您專屬的旅遊網站

設定您的 Rapid API 實作

與任何 API 一樣，在使用 Rapid APIs 之前，您需要先進行一些準備工作。

步驟 1：成為合作夥伴

若要與「Rapid API,」整合，您必須是 Expedia 的合作夥伴。

>> 申請成為合作夥伴

步驟 2：檢視適用的發射要求

請查看您計劃實作的 API 的啟動需求。這些內容將協助您了解哪些需求需要進行前端使用者介面開發，以便您能將其納入專案規劃中。

>> 檢視發射要求

步驟 4：取得憑證並進行驗證設定

一旦您成為合作夥伴，並獲得與 Rapid API, 整合的核准，您就需要取得您的 API 金鑰。您可以透過登入入口網站，並點擊左側選單列中的「連線」來執行此操作。接著在選項中選擇 API 金鑰。您還需要您的共享密鑰，您可以透過進入 Portal 並導航至「API 金鑰」頁面來取得該密鑰。您的 API 金鑰將維持在受限的開發模式下，直至您的網站通過審查，並獲准上線至生產環境為止。

無論是在測試或實際上線時，如要向 Rapid API 服務提出要求，都需要使用 HTTP 授權標頭，才能在每個申請中傳輸 API 金鑰與 SHA-512 簽章雜湊。SHA-512 雜湊是由共用密碼、API 金鑰，以及最新 UNIX 時間戳記組成。Rapid API 的授權標頭始終採用以下格式：

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

收到您的憑證並完成驗證設定後，即可開始向我們的測試端點發送請求，https://test.ean.com/。您在 https://test.ean.com/ 上傳送的任何預訂申請，都不會產生實際的住宿預訂或信用卡費用。您可以從各 API 的文件中記載的測試標頭中進行選擇，以控制您希望看到何種類型的回應。若您在任何 booking-related 請求中省略測試標頭，測試伺服器會自動為您新增一個。

請使用 OpenAPI 規格中的 ``servers.url 值來建構您的 URL。驗證測試應使用test.ean.com，而api.ean.com 則是正式環境的端點。在端點之間切換時保留協定和路徑。

https://test.ean.com/v3/itineraries?…
https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

servers.url 值位於我們可下載的 OpenAPI 規格檔案最上方，並與指定 API 服務的版本號碼相對應。

關於 Rapid Lodging API 的注意事項：為確保我們能提供穩定且易於維護的服務，我們實施了請求速率限制。系統會監控異常的 API 流量，並自動採取保護措施。在對 API 呼叫行為進行任何預定變更，或針對 API 存取進行效能測試之前，請務必與您的 Rapid API 顧問商討您的計畫。

>> 進一步了解速率限制

步驟 6：申請網站審查

熟悉整合並確認符合適用的啟動條件後，請要求您的業務開發管理員執行網站審查。網頁獲准上線後，業務開發管理員將會啟用您的 API 金鑰以應用在實際交易。接著，請將您的請求端點從https://test.ean.com/ 切換至https://api.ean.com，並繼續發送請求。無需進行任何額外的程式碼變更。

警告

若您在切換至https://api.ean.com 後收到 403 禁止存取的回應，請通知您的業務開發經理，並請對方確認您的 API 金鑰是否已針對生產環境端點啟用。Rapid 不會針對我們的生產端點提供開發 API 金鑰的授權。

與我們的其中一家認證技術合作夥伴合作

您是否傾向將 Rapid Lodging API 的開發工作外包？您可以與我們的「菁英」或「首選」技術合作夥伴之一攜手合作，他們能為您設計、建置並優化系統整合方案，讓您能以更少的內部開發資源，更快地正式上線。

>> 探索我們的「認證技術合作夥伴計畫」