開始使用 Rapid API

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

設定您的 Rapid API 實作

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

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

請查閱上的 API 發佈要求 ()，了解您計劃實作的 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 Forbidden 回應，請通知您的業務開發經理，並請他們確認您的 API 金鑰是否已針對生產環境端點啟用。Rapid 不會針對我們的生產端點提供開發 API 金鑰的授權。

與我們的認證技術合作夥伴之一合作

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

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