API 文档

简体中文

English

简体中文

English

外观

2.2.1.4 获取酒店静态内容

约 1853 字大约 6 分钟

2025-11-03

注意

  • 必须
  • Klook通过此接口获取供应商指定酒店 ID 和语言下的所有静态内容（如名称、地址、政策、图片、房型等）

URL

接入方自行定义并提供给klook

入参

字段类型是否必须说明
supplierHotelIdStringtrue接入方酒店 ID
languageStringtrue标准语言 code,默认en_US
1：请参考3.3 字典说明(如 en_US, zh_CN)
2：Klook会根据 2.2.2.5 线下提供及固定配置数据说明 中的静态数据支持的language种类遍历所有语言
Base 入参扩展字段
字段类型是否必须说明
supplierAccountStringfalseopenApi 供应商账号数据
接入方自行定义账号数据
1:账号是为了处理供应商不同账号下资源露出不同的问题,支持多账号
2:若接入方无多账号，则传值为null
3:长度不超过128字符串

入参示例

示例
{
    "base": {
        "requestId": "xxxx",
        "requestTime": "xxx",
        "requestAgent": "xxx",
        "openApiSign": "xx",
        "supplierAccount": "account1",
        "version": "xxx"
    },
    "requestData": {
        "supplierHotelId": "ABC123",
        "language": "en_US"
    }
}

出参

字段类型是否必须说明
hotelIdStringtrue接入方酒店 ID
hotelNameStringtrue接入方酒店名称
categoryIdStringtrue接入方酒店分类
Klook会根据供应商字典supplierKey转换成
Klook分类数据 (dataType = 7)
starStringfalse接入方酒店星级
Klook会根据供应商字典supplierKey转换成
Klook分类数据 (dataType = 19)
groupStringfalse接入方酒店集团
Klook会根据品牌转换成
Klook自己的酒店集团 (dataType = 5)
brandStringfalse接入方酒店品牌
Klook会根据供应商字典supplierKey转换成
Klook分类数据 (dataType = 5)
roomNumintfalse房间数量
floorsintfalse楼层
openDateStringfalse开业时间
lastDecorationDateStringfalse最近装修时间
contactInfoContactInfotrue联系信息
addressInfoAddressInfotrue酒店地址信息
hotelAttrListList<String>true接入方酒店设施
Klook会根据供应商字典supplierKey
进行转换 (dataType = 1)
themeListList<String>false接入方酒店主题
Klook会根据供应商字典supplierKey
进行转换 (dataType = 13)
policyInfoPolicyInfotrue酒店政策
hotelImgListList<ImgDetail>false酒店图片
descInfoDescInfofalse描述信息
rankingintfalse排名
guestRatingDoublefalse用户评分
roomInfoListList<RoomInfo>true房间信息
ContactInfo
字段类型是否必须说明
emailStringfalse酒店邮箱地址
phoneListList<ContactPhone>true酒店电话列表
ContactPhone
字段类型是否必须说明
typeStringtrue电话类型
枚举：
phone_hotel (酒店电话)
phone_booking(预定电话)
phone_service(服务电话)
fax_number (传真)
phoneStringtrue电话号码
AddressInfo
字段类型是否必须说明
longitudeStringtrue经度 (Google 坐标系)
必须
latitudeStringtrue纬度 (Google 坐标系)
必须
postalCodeStringfalse邮政编码
countryStringfalse接入方酒店国家 ID标准国家 code 二字码
provinceStringfalse接入方酒店省份 ID
cityStringfalse接入方酒店城市 ID
areaStringfalse接入方酒店区域信息
addressStringtrue接入方酒店地址
PolicyInfo
字段类型是否必须说明
allowChildbooleantrue是否允许儿童入住，默认允许
childMinAgeinttrue允许儿童最小年龄
childMaxAgeinttrue允许儿童最大年龄
childPolicyStringtrue儿童政策 (比如：不接受18岁以下客人单独入住)
petPolicyStringfalse宠物政策 (比如：不可携带宠物)
extraBedPolicyStringtrue额外加床政策
checkInPolicyCheckInPolicytrue入住政策
CheckInPolicy
字段类型是否必须说明
checkInFromStringtrue最早入住时间
格式 00:00
checkInToStringtrue最晚入住时间
格式 00:00
checkOutToStringtrue最晚退房时间
格式 00:00
checkInMinAgeStringtrue入住最小年龄
ImgDetail
字段类型是否必须说明
urlStringtrue酒店图片地址
primebooleanfalse是否是主图，默认非主图
sizeStringfalse图片大小，像素 (如：800px)
如果不给图片大小，默认全部当成低质量图片处理 (默认=200px)
groupIdStringtrue图片分类
Klook会根据供应商字典supplierKey进行转换
1：酒店图片使用dataType = 15
2：房型图片使用dataType = 2
descStringfalse图片描述
DescInfo
字段类型是否必须说明
amenityDescStringfalse设施描述
diningDescStringfalse餐饮说明
renovationDescStringfalse装修说明
ratingDescStringfalse星级说明
businessAmenitiesDescStringfalse商务设施说明
roomDescStringfalse房间说明
attractionDescStringfalse附近景点说明
locationDescStringtrue地点说明
headlineDescStringfalse标题说明
policyDescStringtrue住宿政策说明
mandatoryFeeDescStringtrue强制费用说明
optionalFeeDescStringtrue可选费用说明
checkInDescStringfalse入住说明
specialInstructionsStringfalse有关入住此住宿的任何特别说明 (可能特定于这家住宿)
checkOutDescStringtrue离店说明
RoomInfo (房间信息)
字段类型是否必须说明
roomIdStringtrue接入方房型 ID
roomNameStringtrue接入方房型名称 (影响 mapping)
roomCountintfalse房间数量
floorsintfalse房间所在楼层
roomDetailBedListList<RoomDetailBed>true房间详情床型列表
单个roomId对应多个房间时，List size = 房间数多个房间之间是且的关系
viewIdListList<String>false接入方房间景观
Klook会根据供应商字典supplierKey进行转换 (dataType = 6)
roomAttrListList<String>false接入方房间设施列表
Klook会根据供应商字典supplierKey进行转换 (dataType = 3)
smokebooleantrue是否可吸烟
true-可吸烟
false-不可吸烟
roomAreaSizeStringtrue房间面积-平方米 (影响 mapping)
roomPolicyInfoRoomPolicyInfotrue房间入住政策
roomDescStringfalse房型描述
roomImgListList<HotelRoomImg>false房型图片
hasWindowbooleanfalse是否含有窗户
RoomPolicyInfo
字段类型是否必须说明
childPolicyStringfalse儿童政策
checkInPolicyCheckInPolicytrue房间入住政策
CheckInPolicy (房间内)
字段类型是否必须说明
maxTotalinttrue最大入住人数
maxAdultinttrue最大成人数
maxChildinttrue最大儿童数
RoomDetailBed (房间床型详情)
字段类型是否必须说明
roomNameStringfalse房间名称
roomDescStringfalse房间描述
bedListList<List<BedStructure>>true房间床型 (影响 mapping)
1：第一层的 List 内部节点是“或”关系
2：第二层 List 内部节点是“且”关系
3：示例：(1张超大床 & 2张单床) 或*(2张大床 & 3张单床)
BedStructure (床型结构)
字段类型是否必须说明
bedIdStringtrue接入方床型类型 ID
Klook会根据供应商字典supplierKey进行转换 (dataType = 11)
bedNameStringfalse接入方床型名称
widthdoublefalse床型宽度，单位米 (影响 mapping)
lengthdoublefalse床型长度，单位米 (影响 mapping)
quantityinttrue床数量

出参示例

示例
{
  "success": true,
  "error": {
    "code": "",
    "message": ""
  },
  "result": {
    "hotelId": " ",
    "hotelName": " ",
    "categoryId": "0",
    "star": "0",
    "group": "0",
    "brand": "0",
    "roomNum": 0,
    "floors": 12,
    "openDate": " ",
    "lastDecorationDate": " ",
    "contactInfo": {
      "phoneList": [
        {
          "type": "phone_hotel",
          "phone": "123456789"
        }
      ],
      "email": " "
    },
    "addressInfo": {
      "longitude": " ",
      "latitude": " ",
      "postalCode": " ",
      "country": " ",
      "province": " ",
      "city": " ",
      "area": " ",
      "address": " "
    },
    "hotelAttrList": [
      "11",
      "222"
    ],
    "themeList": [
      "dsy"
    ],
    "policyInfo": {
      "checkInPolicy": {
        "checkInFrom": " ",
        "checkInTo": " ",
        "checkOutTo": " ",
        "checkInMinAge": " "
      },
      "allowChild": true,
      "childMinAge": 0,
      "childMaxAge": 0,
      "childPolicy": " ",
      "petPolicy": " ",
      "extraBedPolicy": " "
    },
    "hotelImgList": [
      {
        "url": " ",
        "prime": true,
        "size": " ",
        "groupId": "111",
        "desc": " "
      }
    ],
    "descInfo": {
      "amenityDesc": " ",
      "diningDesc": " ",
      "renovationDesc": " ",
      "ratingDesc": " ",
      "businessAmenitiesDesc": " ",
      "roomDesc": " ",
      "attractionDesc": " ",
      "locationDesc": " ",
      "headlineDesc": " ",
      "policyDesc": " ",
      "mandatoryFeeDesc": " ",
      "optionalFeeDesc": " ",
      "checkInDesc": " ",
      "specialInstructions": " ",
      "checkOutDesc": " "
    },
    "ranking": 0,
    "guestRating": 0,
    "roomInfoList": [
      {
        "roomId": " ",
        "roomName": " ",
        "roomCount": 0,
        "floors": 13,
        "roomDetailBedList": [
          {
            "roomName": "大床房",
            "roomDesc": "大床房多张床",
            "bedList": [
              [
                {
                  "bedId": "0",
                  "bedName": "big bed name",
                  "width": 1.2,
                  "length": 2.1,
                  "quantity": 2
                }
              ]
            ]
          },
          {
            "roomName": "双床房",
            "roomDesc": "双床房多张床",
            "bedList": [
              [
                {
                  "bedId": "0",
                  "bedName": "double bed name",
                  "width": 1.2,
                  "length": 2.1,
                  "quantity": 3
                }
              ]
            ]
          }
        ],
        "viewIdList": [
          "1",
          "2"
        ],
        "roomAttrList": [
          "12",
          "22"
        ],
        "smoke": true,
        "roomAreaSize": "25.6",
        "roomPolicyInfo": {
          "checkInPolicy": {
            "maxTotal": 4,
            "maxAdult": 4,
            "maxChild": 2
          },
          "childPolicy": " "
        },
        "roomDesc": "",
        "roomImgList": [
          {
            "url": " ",
            "prime": true,
            "size": " ",
            "groupId": "0",
            "desc": " "
          }
        ],
        "hasWindow": true
      }
    ]
  }
}

KLOOK © 2025 All rights reserved.