酒店详情

约 1150 字大约 4 分钟

2026-03-27

POST 酒店详情

此 API 用于检索特定酒店 ID 列表的酒店详细信息。

默认提供的静态信息包括：酒店基本信息、酒店政策、酒店设施和酒店详情。对于其他静态信息，例如房间信息、图像信息，请联系您的专属 API 客户经理进行配置。

请注意，图片来源于其供应商和直接合同，要有这些图片的版权，图片不能有法律风险。

接口地址

POST /hotel/details

请求参数说明

{
  "language": "en-US",
  "hotelIds": [100]
}

名称	类型	必选	中文名	说明
language	String	否	语言	响应语言
hotelIds	Array	是	酒店ID列表	最多支持 50 个酒店ID

请求示例

curl --location --request POST '{{domain}}/hotel/details' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "language": "en-US",
  "hotelIds": [100]
}'

返回示例

{
    "traceId": "00-059b901c7d78770657bcfa773c4de203-281f3469440212ab-01",
    "timestamp": "1774489926861",
    "data": [
        {
            "language": "en-US",
            "id": 100,
            "name": "The Algonquin Hotel Times Square, Autograph Collection",
            "location": {
                "country": {
                    "code": "US",
                    "name": "Usa"
                },
                "destination": {
                    "code": "178293",
                    "name": "New York (and vicinity)"
                },
                "coordinate": {
                    "longitude": -73.982284,
                    "latitude": 40.75601
                },
                "stateCode": "NY",
                "address": "59 W 44th St",
                "regions": [
                    {
                        "code": "2621",
                        "name": "New York"
                    },
                    ...
                ]
            },
            "telephone": "1-212-840-6800",
            "starRating": 4,
            "zipCode": "10036",
            "airportCode": "LGA",
            "category": {
                "code": "1",
                "name": "Hotel"
            },
            "description": "<p><b>Property Location</b><br/>With a stay at The Algonquin Hotel Times Square, Autograph Collection, you'll be centrally located in New York, within a 5-minute walk of 5th Avenue and Rockefeller Center.  This boutique hotel is 0.2 mi (0.3 km) from Bryant Park and 0.2 mi (0.4 km) from Times Square.</p><p><b>Rooms</b><br/>Make yourself at home in one of the 181 guestrooms featuring iPod docking stations and flat-screen televisions. Your pillowtop bed comes with premium bedding. Wireless internet access (surcharge) keeps you connected, and cable programming is available for your entertainment. Private bathrooms have designer toiletries and hair dryers.</p><p><b>Dining</b><br/>Enjoy a satisfying meal at Lobby serving guests of The Algonquin Hotel Times Square, Autograph Collection. Quench your thirst with your favorite drink at the bar/lounge.</p><p><b>Rec, Spa, Premium Amenities</b><br/>Take advantage of recreation opportunities such as a 24-hour fitness center, or other amenities including complimentary wireless internet access and wedding services. Additional features at this Edwardian hotel include tour/ticket assistance and a banquet hall.</p><p><b>Business, Other Amenities</b><br/>Featured amenities include a 24-hour business center, express check-out, and complimentary newspapers in the lobby. Planning an event in New York? This hotel has 4372 square feet (406 square meters) of space consisting of conference space and 6 meeting rooms.</p>",
            "policy": {
                "description": "<p><b>Special check-in instructions</b><br/>This property doesn't offer after-hours check-in. Front desk staff will greet guests on arrival at the property. Information provided by the property may be translated using automated translation tools.</p><p><b>Know Before You Go</b><br/><ul>  <li>The property has connecting/adjoining rooms, which are subject to availability and can be requested by contacting the property using the number on the booking confirmation. </li><li>This property welcomes guests of all sexual orientations and gender identities (LGBTQ+ friendly).</li> </ul></p><p><b>Fees</b><br/><ul> <li>Fee for in-room wireless internet: USD 0.00 per night (rates may vary)</li><li>Valet parking fee: USD 90 per day</li><li>Pet fee: USD 125.00 per accommodation, per stay</li><li>Service animals are exempt from fees</li></ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change. </p></p><p><b>Mandatory Fees and Taxes</b><br/><p>You'll be asked to pay the following charges at the property. Fees may include applicable taxes:</p> <ul><li>Destination fee: USD 51.63 per accommodation, per night</li></ul> <p>We have included all charges provided to us by the property. </p></p>",
                "checkinFrom": "16:00:00",
                "checkoutTo": "12:00:00",
                "extraInfoList": [
                    {
                        "type": "Pets",
                        "description": "Pets allowed",
                        "value": "Pets allowed"
                    },
                    ...
                ]
            },
            "facilities": [
                {
                    "type": "HotelFacility",
                    "description": "Bar/lounge"
                },
                ...
            ],
            "rooms": [
                {
                    "id": 155446,
                    "name": "Standard Room"
                },
               ...
            ]
        }
    ]
}

返回参数说明

属性	类型	必填	说明
traceId	String	是	唯一标识
timestamp	String	是	请求时间戳
data	Array	否	酒店详情列表

data 对象说明

属性	类型	必填	说明
language	String	是	语言
id	Integer	是	酒店ID
name	String	是	酒店名称
location	Object	是	位置信息
telephone	String	否	电话
starRating	Double	否	星级
zipCode	String	否	邮编
airportCode	String	否	机场代码
category	Object	否	类别信息
description	String	否	描述
policy	Object	否	政策信息
facilities	Array	否	设施列表
images	Array	否	图片列表
rooms	Array	否	房间信息

location 说明

属性	类型	必填	说明
country.code	String	是	国家代码
country.name	String	是	国家名称
destination.code	String	是	目的地代码
destination.name	String	是	目的地名称
coordinate.longitude	Float	是	经度
coordinate.latitude	Float	是	纬度
address	String	是	地址
regions.code	String	是	地区代码
regions.name	String	是	地区名称

policy 说明

属性	类型	必填	说明
description	String	否	政策描述
checkinFrom	String	是	入住时间
checkoutTo	String	是	退房时间
extraInfoList	Array	是	附加信息
extraInfoList.type	String	是	类型
extraInfoList.description	String	是	描述
extraInfoList.value	String	是	退房时间

facilities 说明

属性	类型	必填	说明
type	String	否	类型
description	String	否	描述
value	String	否	值

rooms 说明

属性	类型	必填	说明
id	Integer	否	房间ID
name	String	否	房间名称
maxOccupancy	Integer	否	最大入住人数
size	String	否	房间大小
hasWifi	Boolean	否	是否有WiFi