Room Type Information

About 650 wordsAbout 2 min

POST Room Type Information API

POST /v1.0/static/roomTypeInfo

Request Parameters

{
  "hotelIds": ["11775754", "420032"],
  "language": ""
}

Name	Type	Required	Description
hotelIds	List	Yes	List of hotel IDs (maximum 50)
language	string	No	Language code (zh-CN for Chinese, en-US for English)

Request Example

curl --location --request POST '{{domain}}v1.0/static/roomTypeInfo' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw '{
    "hotelIds":[
        "11775754",
        "420032"
    ],
    "language":""
}'

Response Example

{
  "responseStatus": "SUCCESS",
  "version": "v1.0",
  "hotels": [
    {
      "hotelId": "420032",
      "roomList": [
        {
          "roomId": "2535250",
          "roomName": "豪华套房",
          "maxOccupancy": 2,
          "description": "config.js 张特大床90 平方米  布局 - 用餐区和起居区放松 - 壁炉网络 - 免费 WiFi 和有线上网接入服务 娱乐 - 液晶电视带有收费频道和收费电影餐饮 - 咖啡壶/茶具、迷你吧、24 小时客房送餐服务和免费瓶装水舒适睡眠 - 高档床上用品、夜床服务和床单 浴室 - 私人浴室、浴衣，独立浴缸和淋浴备有雨淋花洒实用 - 保险箱、免费报纸和熨斗及熨板；如有需要，可提供折叠床/加床和免费婴儿床舒适设施/服务 - 恒温控制空调和每日客房清洁无障碍设施 - 浴室扶手无烟客房可要求提供连通房/毗邻房，视供应情况而定",
          "floor": "config.js-3F",
          "useArea": "90m²",
          "bedTypeInfos": {
            "37321": {
              "id": "37321",
              "description": "config.js 张特大床",
              "configuration": [
                {
                  "type": "KingBed",
                  "size": "King",
                  "quantity": 1
                }
              ]
            }
          },
          "amenities": {
            "1073743560": {
              "id": "1073743560",
              "name": "浴室扶手",
              "value": null,
              "categories": null
            },
            "2034": {
              "id": "2034",
              "name": "高档床品",
              "value": null,
              "categories": null
            },
            "1073744653": {
              "id": "1073744653",
              "name": "隐藏式字幕电视",
              "value": null,
              "categories": null
            },
            "2396": {
              "id": "2396",
              "name": "卫星电视服务",
              "value": null,
              "categories": null
            },
            "2030": {
              "id": "2030",
              "name": "房内恒温控制（空调）",
              "value": null,
              "categories": ["air_conditioning"]
            },
            "1073744217": {
              "id": "1073744217",
              "name": "电源适配器/充电器",
              "value": null,
              "categories": null
            }
          },
          "images": [
            {
              "caption": "客房",
              "hero_image": true,
              "category": 21001,
              "links": {
                "350px": {
                  "method": "GET",
                  "href": "https://i.travelapi.com/lodging/5000000/4630000/4624400/4624387/00b32642_b.jpg",
                  "expires": null
                },
                "70px": {
                  "method": "GET",
                  "href": "https://i.travelapi.com/lodging/5000000/4630000/4624400/4624387/00b32642_t.jpg",
                  "expires": null
                }
              }
            },
            {
              "caption": "客房",
              "hero_image": false,
              "category": 21001,
              "links": {
                "350px": {
                  "method": "GET",
                  "href": "https://i.travelapi.com/lodging/5000000/4630000/4624400/4624387/9313725a_b.jpg",
                  "expires": null
                },
                "70px": {
                  "method": "GET",
                  "href": "https://i.travelapi.com/lodging/5000000/4630000/4624400/4624387/9313725a_t.jpg",
                  "expires": null
                }
              }
            },
            {
              "caption": "酒廊",
              "hero_image": false,
              "category": 82001,
              "links": {
                "350px": {
                  "method": "GET",
                  "href": "https://i.travelapi.com/lodging/5000000/4630000/4624400/4624387/871f58db_b.jpg",
                  "expires": null
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "remark": ""
}

Field	Type	Description
responseStatus	string	Response status
version	string	API version
remark	string	Additional remarks
hotels	List	List of hotels
hotelId	string	Hotel ID
roomList	List	List of room types
roomId	string	Room type ID
roomName	string	Room name
maxOccupancy	int	Maximum occupancy
description	string	Room description
floor	string	Floor
useArea	string	Area (m²)
bedTypeInfos	List	Bed type collection
bedTypeInfo	List	Bed type details
id	string	Bed type ID
description	string	Bed type description
configuration	list	Bed configuration
type	string	Bed type
size	string	Bed size
quantity	int	Number of beds
amenities	list	Room amenities
id	string	Amenity ID
name	string	Amenity name
value	string	Amenity value
categories	[string]	Amenity categories
images	list	Room images

Status Codes

Code	Description
SUCCESS	Request successful
NO_FIND	No data found
UNAUTHORIZED	Authentication failed
HOTEL_SIZE	Hotel count exceeds maximum limit
SUPPLIER_SERVER_ERROR	Server or upstream API error