Postman 集合
使用 Postman 測試 Rapid API 端點,並查看具體的請求/回 應格式
目前有貨
目前,我們提供以下 Postman 集合:
- Rapid Lodging API (通知服務除外)
- Rapid Car API
Rapid Flight 和 Activities API 即將推出更多集合,但這些 API 目前尚未正式上線。
註: 這些請求是根據網站上的 Swagger 文件進行分組的。
這些集合的設計旨在盡可能符合 self-contained 原則——它們將驗證邏輯封裝起來,並在每次請求時使用 check-in/check-out self-update。每個集合都包含一些基本測試,可與 Postman 的集合執行器功能搭配使用。
安裝
請從的「下載 Postman 集合」區段下載這些集合,然後將其匯入 Postman。
先決條件與系統需求
請參閱以及 Postman 文件以獲取更多資訊。
api_key和shared_secret。- Postman 的最新版本。
注意:請勿編輯或修改「編輯收藏集」區段。變量和代碼必須保持不變,以確保請求如預期運作。
設定
Postman 採用其專屬的格式來處理變數。在使用這些集合之前,您需要設定一些環境變數。
可以定義以下參數,其中只有兩項必須進行設定:
| 鑰匙 | 預設 | 必填 | 說明 |
|---|---|---|---|
api_key | 無資料 | 是 | API 金鑰。 |
shared_secret | 無資料 | 是 | 您的共用密碼。 |
eanapi_url | https://test.ean.com/ | — | 要定位哪個主機,您可能希望透過 https://api.ean.com 加以覆寫 |
property_id | 3609882 | — | 在內容和供應情況呼叫中所請求的 LCM/Expedia property_id。 |
region_id | 178248 | — | 地理相關呼叫中所請求的區域。 |
iata_airport_code | ORD | — | 地理相關呼叫中所請求的 IATA 機場代碼。 |
iata_airport_metro_code | CHI | — | 地理相關呼叫中所請求的 IATA 都會區機場代碼。 |
language | en-US | — | 請求的本地化語言,BCP47 格式的子集。 |
occupancy | 2 | — | 所請求的每個房間人數,格式為 numberOfAdults[-firstChildAge[,nextChildAge]]- "2-9,3" 代表兩位成年人、一名九歲孩童、一名三歲孩童。 |
booking_email | john@example.com | — | 預訂申請中使用的電子郵件。 |
hold_itinerary_creation | true | — | 行程是否將在保留狀態下建立。 |
billing_terms | 無資料 | —* | 產生之預訂的請款期限。 |
partner_point_of_sale | 無資料 | —* | 應使用哪個銷售點系統來配合購物與預訂 API。 |
payment_terms | 無資料 | —* | 針對產生之預訂進行付款時,應使用的付款方式。 |
platform_name | 無資料 | —* | 使用什麼平台進行購物和預訂。 |
* 注意:這些變數僅在api.ean.com; 對於 ** # 則不需要 test.ean.com** 時則非必要。
以下參數為 auto-generated,並會自動設定於您的環境中:
| 鑰匙 | 全球 | 說明 |
|---|---|---|
authorizaton | 是 | 此授權碼是從您的 api_key 和 shared_secret 所產生,並用做請求標頭。 |
checkin | 是 | checkin 日期是為供應情況請求自動產生。日期會是從您提出請求日起的 30 天。 |
checkout | 是 | checkout 日期是為供應情況請求自動產生。日期會是從您提出請求日起的 32 天。 |
arrival | 是 | arrival 時間是為交叉銷售請求自動產生。日期會是從您提出請求日起的 30 天。 |
affiliate_reference_id | — | affiliate_reference_id 用於建立預訂申請,可用於擷取後續預訂。 |
price_check_link | — | 如果回傳的住宿具有該連結,則在供應情況、交叉銷售或推薦申請之後設定 price_check_link。此要素可用於提出價格檢查申請。 |
payment_options_link | — | 如果回傳的住宿具有該連結,則在供應情況、交叉銷售或推薦申請之後設定 payment_options_link。此要素可用於提出價格選項申請。 |
deposit_policies_link | — | 如果回傳的住宿具有該連結,則在供應情況、交叉銷售或推薦申請之後設定 deposit_policies_link。此要素可用於提出訂金規定申請。 |
book_link | — | 如果回傳的住宿具有該連結,則在價格檢查申請之後設定 book_link。此要素可用於提出預訂申請。 |
retrieve_link | — | 如果回傳的行程具有該連結,則在預訂申請之後設定 retrieve_link。此要素可用於提出擷取申請。 |
resume_link | — | 如果回傳的行程具有該連結,則在預訂申請之後設定 resume_link。此要素可用於提出恢復申請。 |
cancel_link | — | 如果回傳的行程具有該連結,則在預訂申請之後設定 cancel_link。此要素可用於提出取消申請。 |
cancel_room_link | — | 如果回傳的行程具有該連結,則在預訂申請之後設定 cancel_room_link。此要素可用於提出取消客房申請。 |
change_room_link | — | 如果回傳的行程具有該連結,則在預訂申請之後設定 change_room_link。此要素可用於提出變更客房申請。 |
complete_payment_session_link | — | 如果回傳的行程具有該連結,則在預訂申請之後設定 complete_payment_session_link。此要素可用於提出完成付款階段申請。 |
pagination_link | — | 在對任何分頁端點提出的任何申請之後會設定 pagination_link。可用於展示 API 中的分頁會如何運作。 |
推薦設定
我們建議您在僅設定了eanapi_url 和api_keyshared_secret 的環境中定義這些變數。
下載 Postman 集合
在下載這些資料集之前,請務必閱讀本頁面的說明。