其他資訊
充分利用商品化 API 的實用資訊。
- 分頁: 商品管理 API 採用與其他 API 相同的分頁體驗。Rapid API.閱讀更多關於分頁的資訊。
- 語言: 請以符合 BCP47 格式的子集形式提供期望的回應語言,該格式僅使用連字號連接的雙碼組合,包含 two-digit 語言代碼與國家代碼。僅使用 ISO 639-1 alpha-2 語言代碼和 ISO 3166-1 alpha-2 國家/地區代碼。目前僅用於生成指向其他 API 的連結。
- 旅宿內容 API 連結: 合作夥伴將收到現有 Rapid 旅宿內容 API 的代幣化連結,用以獲取旅宿詳情,例如名稱、地址、設施等。
- 請務必注意,Rapid 購物 API 上的費率方案可用性與價格會持續變動。因此,您將在購物 API 回應中始終看到最優惠的可用價格 (根據入住率與住宿日期等請求參數而定)。這有時意味著,透過購物 API 獲得的折扣或價格可能比促銷 API 回應中顯示的更優惠。
- 若您不符合使用 member-only 或行動方案的資格,我們將不會提供這些方案。請聯絡您的客戶經理以獲取更多詳情。
- 最大與最小折扣值:
max_discount欄位顯示活動中可提供的最高折扣百分比。例如,若某次活動中旅宿提供的最高折扣為 60%減價,則 API 回應中的max_discount值將顯示為 60%。min_discount欄位顯示活動中可提供的最低折扣百分比。例如,若某個旅宿在該活動中提供的最低折扣為 4%,則min_discount欄位值即為 4%。
- 可預訂與入住日期範圍:
- 活動內容與促銷終端點所傳遞的回應,將完全符合所請求的可預訂時段、旅行時段 (及結束日期)。
- 您可以使用
bookable和bookable_end參數作為篩選條件,透過大於和小於的邏輯進行篩選。這意味著,若您要求交易的「開始日期」(bookable)為 4 月 1 日,且「結束日期」(bookable_end)為 4 月 30 日,您僅會收到完全符合此條件的交易。若某項優惠活動於 4 月 15 日至 5 月 15 日期間分別設有「bookable」與「bookable_end」兩項條件,您將無法獲得此優惠。同樣的邏輯也適用於住宿日期。 - 若您想在活動中向旅客顯示「僅剩 XX 天」的倒數,可透過活動內容中的日期欄位 (
bookable) 與截止日期欄位 (bookable_end) 計算此天數。