擴大 Rapid Lodging API 的全球庫存
擴大全球庫存,參與全球競爭
Expedia 擴展的全球庫存 (EGI) 可協助您與全球 34,000 多家飯店競爭,並且會定期增加更多庫存。這包括新採購的房產和當前採購的房產的額外庫存。
技術細節
EGI 不是 Rapid API 中標準庫存的一部分,但可以根據請求明確啟用。它具有與標準庫存不同的動態行為和整合模式,需要特別注意內容提取、購物和預訂工作流程。
內容文件
EGI 的快速內容檔案和目錄檔案 API 目前僅支援 English-language 內容。如果您的系統需要本地化 (non-English) 內容文件,您可以使用屬性內容和地理 API 在本地生成它們。這些 API 為所有內容語言提供 real-time 流和靈活的資料處理,從而可以輕鬆地從 JSON-formatted API 回應中提取必要的資訊。您可以在本機上儲存原始 JSON 回應以供稍後處理,或將其轉換為資料庫匯入或其他用例。
使用地理 API 請求某個區域的屬性清單的範例:
/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_ids使用 Property Content API 請求目錄內容的範例:
/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalog您可以選擇優先啟動 EGI 的內容集成,同時分配額外的時間來審查購物和預訂工作流程,或者當您為 EGI 做好準備時,可以同時啟動所有三個組件。有關配置詳細信息,請聯繫您的整合顧問。
客房資料對齊
在您的系統與 Property Content API 完全同步之前,新的房產房間可能會出現在 Shopping API 中。為了保持一致的使用者體驗,請考慮暫時將這些房間從客戶顯示中排除,觸發新客房的 real-time 內容 API 調用,或增加本地內容更新的頻率以最大限度地減少資料延遲。
速率標識符
EGI 費率的結構與標準庫存不同,並遵循更動態的資料模型。由於這些費率沒有靜態值,因此購物 API 會傳回動態 rate_id值,該值與 Property Content API 中的值不對應。此動態字串值由數字、字母和各種其他符號組成,每個購物 API 回應中可能有所不同。因此,rate_id 值不穩定,不應用作持久標識符或主鍵。如果您的系統需要區分不同流程的費率,請考慮將它們與策略屬性和報價特徵的組合進行配對。請參閱此安全文件以了解更多詳細資訊。
購物 API 回應中的 rate_id 值範例:
[
{
"property_id": "ABC152",
"status": "available",
"rooms": [
{
"id": "XYZ652",
"room_name": " Deluxe Double ",
"rates": [
{
"id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
… …床床配置變化
在特殊情況下,某些房間可能沒有指定的床位配置,內容和購物 API 中均透過 bed_groupsID 0 和描述「未指定床位」來指示。這意味著酒店將根據 check-in 確定床位安排。雖然這種情況很少見,但您的系統應該讓客戶了解情況,如果他們有強烈的偏好,則協助他們將特殊要求傳達給我們的客戶營運團隊。
購物 API 回應中未指定的床床配置範例:
{
"bed_groups": {
"0": {
"id": "0",
"description": "Bed Not Specified",
"links": {
"price_check": {
… …保留和復原
某些 EGI 費率與預訂 API 保留和恢復工作流程不相容,如果嘗試保留,將會傳回錯誤。為了防止糟糕的客戶體驗,您可以在購物 API 回應中要求可持有費率標誌,並按照它來應用正確的工作流程。
請求可持有利率標誌的範例:
Request:
/properties/availability?... …&include=rooms.rates.holdable
Response:
… …
"rooms": [
{
"id": "XYZ652",
"room_name": "Deluxe Double Room",
"rates": [
{
"id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
“holdable”: true,
… …Post-booking 功能
透過預訂 API 確認預訂後,預訂資訊將在管理預訂 API 中提供。用於存取 post-booking 功能 (包括軟更改、硬更改和屬性訊息中心) 的令牌連結也將在管理預訂 API 中提供。有時,令牌連結可能需要長達五分鐘才能準備好。值得注意的是,這些功能並非適用於所有預訂,應在您的系統內妥善管理。
EGI 的主要區別
| 特徵/行為 | 標準庫存 | 擴大全球庫存 |
|---|---|---|
| 預設可用性 | 預設啟用 | 根據要求激活 |
| 速率標識符 | 靜態、持久 | 動態,因商店而異 |
| 內容解決方案 | 相容於檔案 API 和流內容 API | 相容於英語內容的文件 API 和所有語言的串流內容 API |
| 內容同步需求 | 每日同步熱門房源 | 每日同步熱門房源 |
| 床型和數量設定 | 指定的 | 在極少數情況下可能未指定 |
| 保留和復原 | 適用於所有預訂 | 部分預訂可用 |
| Post-booking 功能 | 適用於所有預訂 | 部分預訂可用 |