開始使用 Rapid

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

1. 成為合作夥伴

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

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

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

• B2B 純訂房
• B2C 純訂房

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 上使用的標頭，以控制您想看到的回應類型；若您在任何預訂相關要求中未加入測試標頭，測試伺服器便會自動幫您加入。

**重要提示：**為了確保能提供所有合作夥伴穩定且不間斷的服務，系統有速率限制。系統會監控異常的 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 並繼續發出要求即可，無須執行額外的程式碼變更。