內容參考 API

「內容參考 API」可協助您更深入理解 Rapid 旅宿的內容。

Rapid Content APIs 中提供的旅宿相關資訊 (包括旅宿或客房層級可用的設施或服務、附加價值，以及費率相關設施)，均以數值 ID 表示。使用「內容參照 API」來 self-serve 屬性 ID 及其含義的清單。

參考資料詳情

設施服務

設施是指提供給旅客的各項功能或服務。

在 Rapid Content APIs 中，我們針對id 物件內的每項設施，提供其name、本地化版本value 以及明確的amenities（如適用）。

設施服務可見於旅宿、客房和房價計畫等三個層級，且除非規定載明付費或限制條件，設施服務皆為免費使用。

旅宿層級：所有旅客均可享用相關設施。
**房型層級：**僅相關客房可使用的設施服務。
**房價層級：**僅相關房價計畫可使用的設施服務。

請尋找 amenities_property、amenities_rooms` ` 及 amenities_rates 這三個物件。

每項設施包含 3 個欄位：

id
name
has_value

「內容 API」回應範例：

"amenities": {
    "9": {
        "id": 9,
        "name": "Fitness facilities"
    },
    "2820": {
        "id": 2820,
        "name": "Number of indoor pools -",
        "value": 10
    }
},

設施服務類別

設施服務類別允許對相關設施服務進行分組以供顯示、搜尋或篩選。

在 Rapid Content APIs 中，categories 物件用來描述某項設施所屬的類別。這讓您能更輕鬆地將相關的設施分組，以便顯示、搜尋或篩選。

「內容 API」回應範例：

{
  "12345": {
    "property_id": "12345",
    ...
    "amenities": {
      "2070": {
        "id": "2070",
        "name": "Dry cleaning/laundry service",
        "categories": [
          "drycleaning_and_laundry_services"
        ]
      }
    }
  }
}

可用類別

accessibility
accessible_parking
accessible_wheelchair
air_conditioning
airport_transfer
all_inclusive
bar
casino
crib
dry_cleaning_laundry
dryer
electric_charging_station
free_airport_transfer
free_all_meals
free_breakfast
free_breakfast_1_or_2_guests
free_dinner
free_lunch
free_wifi
gym
hot_tub
kitchen
meeting_facility
ocean_view
parking
pets_allowed
spa_services
swimming_pool
washer
water_park
wifi

屬性

屬性代表飯店與住宿所適用的規定和特色。

在 Rapid Content APIs 中，我們提供id 物件中該屬性的name、本地化版本value，以及明確的attributes（如適用）。

屬性可見於旅宿層級，指的是旅宿和住宿的規定和特色。

general：旅宿採用的一般規定。
pets: 適用於旅宿的寵物政策。

請尋找 attributes_general 和 attributes_pets 這兩個物件。

每個屬性包含 3 個欄位：

id
name
has_value

「內容 API」回應範例：

"attributes": {
    "general": {
        "2549": {
          "id": 2549,
          "name": "No elevators"
        },
        "3357": {
          "id": 3357,
          "name": "Caters to adults only"
        }
    },
    "pets": {
        "51": {
          "id": 51,
          "name": "Pets allowed"
        },
        "2809": {
          "id": 2809,
          "name": "Dogs only"
        }
    }
},

類型

每家旅宿僅可設定一種旅宿類別，所指的是該旅宿的類型。

在 Rapid Content APIs 中，我們於id 物件內，同時提供旅宿類別的name 與category 兩個連結。

每家旅宿僅可設定一種旅宿類別，所指的是該旅宿的類型。

請尋找名為「category」的物件。

每個類別包含 2 個欄位：

id
name

「內容 API」回應範例：

"category": {
    "id": 1,
    "name": "Hotel"
},

以下為旅宿類別清單，供作參考。

`id`	`name`
0	旅宿
1	飯店
2	汽車旅館
3	度假村
4	旅店
5	民宿
6	家庭旅館
7	共管公寓
8	全包式住宿
9	木屋
10	山區木屋
11	鄉間房屋
12	青年旅館/背包客住宿
13	牧場
14	別墅
15	郊外小屋
16	出租公寓
17	私人度假屋
18	船屋
20	日式旅館
21	樹屋
22	飯店式公寓
23	公寓式度假村
24	營地
25	摩洛哥特色住宿
26	平價旅館
29	鄉村旅館
30	膳宿旅館
31	葡萄牙古蹟旅館
32	巴西特色住宿
33	法義公寓式飯店
34	義式旅館
36	城堡
37	遊獵營地
39	宮殿
40	觀光農場
41	遊輪
42	度假營地
43	膠囊旅館
44	移動式房屋

鏈式引用

連鎖旅宿指的是旗下有多個相關品牌的母公司。

在 Rapid Content API 中，我們提供了所有已識別鏈的鏈參考映射。

每家旅宿僅可設定一個品牌；品牌則有其隸屬的母公司/連鎖旅宿。

「內容 API」回應範例：

"chain": {
      "id": -6,
      "name": "Hyatt Hotels"
    },
    "brand": {
      "id": 2209,
      "name": "Hyatt Place"
    },

相片

根據圖片呈現的旅宿部分，按類別來分類圖片。

在 Rapid Content APIs 中，針對每張旅宿圖片，我們會在category 欄位中提供類別 ID，並在caption 欄位中提供類別名稱。客房的圖片也有圖說。

請尋找名為「images」的物件。

每個圖片類別包含 2 個欄位：

id
name

「內容 API」回應範例：

"images": [
    {
        "caption": "Featured Image",
        "hero_image": true,
        "category": 3,
        "links": {
            "350px": {
                "method": "GET",
                "href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_b.jpg"
            },
            "70px": {
                "method": "GET",
                "href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_t.jpg"
            },
            "1000px": {
                "method": "GET",
                "href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_z.jpg"
            }
        }
    },
]

飯店內付款方式

旅宿內付款方式會呈現所產生費用或於旅宿付款時能接受的付款方式。

在 Rapid Content APIs 中，我們於id 物件內的name 物件中，提供站內付款類型的types 以及其本地化版本onsite_payments。

住宿內付款方式見於旅宿層級，指的是住宿內產生的費用可接受的付款方式。

請尋找名為「onsite_payment_types」的物件。

每種付款方式包含 2 個欄位：

id
name

「內容 API」回應範例：

"onsite_payments": {
    "currency": "USD",
    "types": {
        "171": {
          "id": 171,
          "name": "American Express"
        }
    }
},

統計數字

統計數字指的是旅宿層級資料，例如：樓層數和客房數。

在 Rapid Content APIs 中，我們會在id 物件內提供該統計資料的name、本地化版本value，以及明確的statistics（如適用）。

統計數字可見於旅宿層級，指的是樓層數和客房數等的資料。

請尋找名為「statistics」的物件。

每個統計資料包含 3 個欄位：

id
name
value

「內容 API」回應範例：

"statistics": {
    "52": {
        "id": 52,
        "name": "Total number of rooms -",
        "value": "820"
    },
    "54": {
        "id": 54,
        "name": "Number of floors -",
        "value": "38"
    }
},

主打特色

主打特色指的是目標旅客類型或旅宿整體氣氛。

在 Rapid Content APIs 中，我們於id 物件內同時提供該主題的name 以及本地化版本themes。

主打特色可見於旅宿層級，指的是目標旅客類型或旅宿整體氣氛。一家旅宿可設定一種以上的主打特色，但不見得每家旅宿都有主打特色。

請尋找名為「themes」的物件。

每個主題包含 2 個欄位：

id
name

「內容 API」回應範例：

"themes": {
    "2337": {
        "id": 2337,
        "name": "Luxury Hotel"
    },
    "2341": {
        "id": 2341,
        "name": "Spa Hotel"
    }
},

客房景觀

客房景觀是指從該客房可看到的景觀。

在 Rapid Content API 中，我們提供了可從id 物件取得之檢視的name 以及本地化版本views。

請尋找名為「room_views」的物件。

每個檢視包含 2 個欄位：

id
name

「內容 API」回應範例：

"views": {
          "4146": {
            "id": 4146,
            "name": "Courtyard view"
          }
        },

交談語言

「使用語言」指的是旅宿工作人員所使用的語言。

在 Rapid Content API 中，我們會從id 物件中提供該語言的spoken_languages 以及其本地化名稱。

請尋找名為「spoken_languages」的物件。

每種語言包含 2 個欄位：

id
name

「內容 API」回應範例：

"spoken_languages": {
      "vi": {
        "id": "vi",
        "name": "Vietnamese"
      }
    },