開始使用 Rapid

開始使用 Rapid 很簡單，只需取得 API 金鑰與共用密碼、進行 Rapid 驗證設定，然後開始執行測試即可。

1. 成為合作夥伴

如果您還不是合作夥伴，則必須先申請成為合作夥伴，才能整合 Rapid。

2. 查看適用於您網站的啟動條件

查看啟動條件，確認哪些要求需要前端使用者介面開發，並將其納入專案計畫。

• B2B 純訂房
• B2C 純訂房

• Vrbo

3. 準備環境

參考以下資源，為使用 Rapid 準備環境。

• 運作方式
• 處理預訂申請
• 建構取消規定

4. 取得憑證並進行 Rapid 驗證設定

成為合作夥伴並獲准與 Rapid 進行整合後，您必須取得 API 金鑰。您可以登入 EPS 入口網站，然後按一下左側功能表列中的串接執行此動作。接著在選項中選擇 API 金鑰。入口網站將顯示您目前的 API 金鑰詳細資訊。

API 金鑰是 Rapid 簽章驗證系統所需的兩個金鑰憑證之一。您還需要共用密碼，只要前往 EPS 入口網站並瀏覽至 API 金鑰頁面，即可取得此密碼。在網站審查核准進入生產環境前，API 金鑰會處於有限開發模式。

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

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

請參閱我們的簽名認證頁面的完整詳細資訊。您可以使用我們的簽章產生器工具產生 SHA-512 雜湊值，以測試整合效果。

5. 開始測試要求

收到憑證並進行 Rapid 驗證設定後，即可開始針對以下測試端點發出要求：https://test.ean.com/。您在 https://test.ean.com/ 上傳送的任何預訂申請，都不會產生實際的住宿預訂或信用卡費用。您可以從我們記錄的 [預訂 API]lodging/booking/rapid-booking-test-request) to control what type of response you want to see, or if you omit a test header for any booking-related request, the test server will add one for you automatically.

**重要提示：**為確保我們提供穩定且可維護的服務，我們應用了速率限制。系統會監控異常的 API 流量，並自動採取保護措施。在針對呼叫 API 的行為進行計劃性變更或使用 API 進行績效測試前，請務必與 Rapid 顧問討論您的計畫。

指定 API 版本

使用 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 服務的版本號碼相對應。

範例：OpenAPI 規格

openapi: 3.0.1
info:
  title: Rapid
  description: EPS Rapid V3
  version: v3
servers:
  - url: https://test.ean.com/v3

6. 申請網站審查

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