酒店列表

GET

/api/hotel/search

按城市/关键词/商圈/品牌/星级/日期/价格搜索

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "brandCode": "HJ",
    "businessCircleCode": "330100_0100",
    "checkInDate": "2026-09-01",
    "checkOutDate": "2026-09-02",
    "cityCode": 330100,
    "keyword": "西湖",
    "latitude": 30.24603,
    "longitude": 120.120105,
    "page": 0,
    "size": 20,
    "sorts": "reputation-desc",
    "star": 4,
    "supportHourRoom": false,
    "themeType": "A"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/api/hotel/search?appId=undefined&nonce=undefined&sign=undefined&timestamp=undefined' \
--header 'Content-Type: application/json' \
--data '{
    "brandCode": "HJ",
    "businessCircleCode": "330100_0100",
    "checkInDate": "2026-09-01",
    "checkOutDate": "2026-09-02",
    "cityCode": 330100,
    "keyword": "西湖",
    "latitude": 30.24603,
    "longitude": 120.120105,
    "page": 0,
    "size": 20,
    "sorts": "reputation-desc",
    "star": 4,
    "supportHourRoom": false,
    "themeType": "A"
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "list": [
        {
            "address": "杭州市西湖区北山街X号",
            "brandCode": "BRAND_A",
            "brandName": "华住",
            "businessCircleCode": 33010001,
            "businessCircleName": "西湖风景区",
            "hotelId": 10001,
            "latitude": 30.24603,
            "longitude": 120.120105,
            "mainImage": "string",
            "maxOccupancy": 2,
            "minPrice": 20000,
            "name": "杭州西湖大酒店",
            "salePrice": 32000,
            "settlePrice": 30000,
            "star": 4,
            "supportHourRoom": false
        }
    ],
    "total": 0
}

🟠401

🟠403

🟠404

修改于 2026-09-10 09:32:08

房型报价

取消/退单