其他資訊

充分利用 Merchandising API 的實用資訊。

1. 分頁： Merchandising API 的分頁操作方式與其他部分相同 Rapid API.進一步了解分頁功能。
2. 語言： 請以 BCP47 格式的子集形式提供回應所需的語言，該格式僅使用由兩位數語言代碼與國家代碼組成的連字形式。僅使用 ISO 639-1 alpha-2 語言代碼和 ISO 3166-1 alpha-2 國家/地區代碼。目前僅用於產生連結至其他 API。
3. 旅宿內容 API 連結： 合作夥伴將收到一個指向現有 Rapid 旅宿內容 API 的代幣化連結，以便取得旅宿的詳細資訊，例如名稱、地址、設施等。
4. 請務必注意，Rapid 的購物 API 上的費率方案供應狀況與價格會隨時變動。因此，您在「購物 API」的回應中，將始終看到當前最佳的可用房價 (依據入住率及入住日期等請求參數而定)。這有時意味著，透過 Shopping API 獲得的折扣或價格，可能會比 Promotions API 回應中顯示的更優惠。
5. 若您不符合申請 member-only 或行動方案的資格，我們將不予受理相關申請。如需進一步詳情，請聯絡您的客戶經理。
6. 折扣的最高值與最低值：
   • 「max_discount」欄位表示該活動中可享的最高折扣百分比。例如，若旅宿在該活動中提供的最高折扣為 60%，則 API 回應中的max_discount 值即為 60%。
   • 「min_discount」欄位表示該活動中可享的最低折扣百分比。例如，如果旅宿在該活動中提供的最低折扣為 4%，則min_discount 欄位的值即為 4%。
7. 可預訂及入住日期範圍：
   • 活動內容與促銷服務端所傳回的回應，將完全符合所請求的可預訂時段及旅行時段 (以及截止日期)。
   • 您可以將bookable 和bookable_end 作為篩選條件，並運用大於與小於的邏輯進行篩選。這表示，若您查詢的優惠活動「開始日期」（bookable）為 4 月 1 日，且「結束日期」（bookable_end）為 4 月 30 日，您將只會收到完全符合此條件的優惠活動。如果某項優惠的「bookable」和「bookable_end」分別在 4 月 15 日至 5 月 15 日期間，您將無法獲得此優惠。同樣的邏輯也適用於住宿日期。
   • 若您希望向旅客顯示某項活動的「僅剩 XX 天」，可透過活動內容中的bookable 和bookable_end 這兩項日期來計算此數字。