马蜂窝开放平台

查询酒店信息及关联的房型信息

查询酒店信息及关联的房型信息
注意：
通过此接口首次查询酒店信息会将酒店信息与该商家进行关联并且返回该酒店及关联的房型信息。

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.hotel.room.detail.get

请求参数

参数名称	参数类型	必填	示例	描述
hotel_id	int	是	123456	马蜂窝酒店ID

响应参数

参数名称	参数类型	示例	描述
zh_name	string	北京大酒店	酒店中文名称
foreign_name	string	Golden Oasis Hotel	酒店外语名称
address	string	永外彭庄甲58号（近北京南站)	酒店地址
built_time	int	2007	建筑时间
renovation_time	int	2015	重修时间
total_rooms	int	154	房间数量（酒店规模）
star	int	3	星级
mdd_id	int	10065	所在目的地ID
mdd_name	string	中国-北京	所在目的地
hotel_cid	int	123456	酒店资源ID
hotel_id	int	12342	马蜂窝酒店ID
cover_imgs	array	[]	酒店外观图片
└ https://n3-q.mafengw.jpeg	string	0	外观图片url
inner_imgs	array	[]	酒店内景图片
└ https://n3-q.mafengw.jpeg	string	0	酒店内景图片url
room_imgs	array	[]	酒店房间图片
└ https://n3-q.mafengw.jpeg	string	0	酒店房间图片url
description	string	酒店是一座假日酒店	酒店介绍
check_in_from	time	14:00	入住开始时间
check_in_to	time	18:00	入住结束时间
check_out_to	time	12:00	退房截止时间
main_facs_include	array	[]	包含主要设施
{}	object	0
└ tag_id	int	12342	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
common_service_include	array	[]	包含通用设施
{}	object	0
└ tag_id	int	23412	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
hotel_service_include	array	[]	包含酒店服务
{}	object	0
└ tag_id	int	12323	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
main_facs	array	[]	可选主要设施
{}	object	0	设施信息
└ tag_id	int	12342	设施/服务ID
└ tag_name	string	免费无线上网	设施名称
hotel_service	array	[]	可选酒店服务
{}	object	0
└ tag_id	int	12323	设施ID
└ tag_name	string	设施名称	设施名称
common_service	array	[]	可选通用设施
{}	object	0
└ tag_id	int	23412	设施ID
└ tag_name	string	设施名称	设施名称
room_list	array	[]	酒店房型信息
{}	object	0	房型信息
└ room_cid	int	12	酒店房型资源ID
└ zh_name	string	精选套间	房型名称
└ foreign_name	string	Deluxe Suite	房型外语名称
└ bed_type	string	2张单人床	床型介绍
└ size	string	20-40	房间面积单位（平方米）
imgs	array	[]	房间图片
└ https://dev-df.jpeg	string	0	房间图片
└ desc	string	房型描述	房型描述
bed_params	array	[]	床型信息
{}	object	0
└ bed_length	number	2	床型长度单位（米）
└ bed_type	int	1	床型类型，1-大床，2-单人床
└ bed_width	number	1	床型宽度单位（米）
└ quantity	int	1	床的数量
└ floor	string	3-7	房型分布楼层
└ adult_max	int	2	最多可入住成人数量
└ kid_max	int	2	最多可入住儿童数量
child_policy	object	{}	儿童政策
age	object	{}	儿童年龄政策
└ min	int	1	最小年龄
└ max	int	2	最大年龄
height	object	{}	儿童身高政策
└ min	int	120	最小身高单位（厘米）
└ max	int	160	最大身高单位（厘米）
└ add_bed_type	int	1	加床政策，1-不可加床，2-免费加床，3-付费加床
└ add_bed_desc	string	加床说明	加床说明
└ allow_smoking	int	1	是否允许抽烟，0-不允许，1-允许
└ window	int	1	是否有窗，0-无窗，1-有窗
└ bathroom	int	1	1 // 卫浴设施，1-独立卫浴，2-公共卫浴
└ reference_number	int	11	引用该资源的sku数量
network	array	[]	可选网络设施
{}	object	0
└ tag_id	int	12342	设施/服务ID
└ tag_name	string	免费无线上网	设施/服务名称
network_include	array	[]	包含网络设施
{}	object	0
└ tag_id	int	12342	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
room_service	array	[]	可选客房服务
{}	object	0
└ tag_id	int	12352	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
room_service_include	array	[]	包含客房服务
{}	object	0
└ tag_id	int	12352	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
meal_facs	array	[]	可选餐食相关
{}	object	0
└ tag_id	int	12347	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
meal_facs_include	array	[]	包含餐食相关
{}	object	0
└ tag_id	int	12347	服务/设施ID
└ tag_name	string	设施/服务名称	设施/服务名称
bathroom_facs	array	[]	可选浴室设施
{}	object	0
└ tag_id	int	34353	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
bathroom_facs_include	array	[]	包含浴室设施
{}	object	0
└ tag_id	int	34353	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
room_facs	array	[]	可选客房设施
{}	object	0
└ tag_id	int	12134	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
room_facs_include	array	[]	包含客房设施
{}	object	0
└ tag_id	int	12134	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
entertainment_facs	array	[]	可选休闲娱乐
{}	object	0
└ tag_id	int	34353	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
entertainment_facs_include	array	[]	包含休闲娱乐
{}	object	0
└ tag_id	int	34353	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
special	array	[]	可选特殊情况
{}	object	0	可选特殊情况
└ tag_id	int	12342	设施/服务ID
└ tag_name	string	设施/服务名称	设施/服务名称
special_include	array	[]	包含特殊情况
{}	object	0
└ tag_id	int	12342	设施/服务ID
└ tag_name	string	34235	设施/服务名称

响应示例

{
    "zh_name":"北京大酒店",
    "foreign_name":"Golden Oasis Hotel",
    "address":"永外彭庄甲58号（近北京南站)",
    "built_time":"2007",
    "renovation_time":"2015",
    "total_rooms":"154",
    "star":"3",
    "mdd_id":"10065",
    "mdd_name":"中国-北京",
    "hotel_cid":"123456",
    "hotel_id":"12342",
    "cover_imgs":[
        "https://n3-q.mafengw.jpeg"
    ],
    "inner_imgs":[
        "https://n3-q.mafengw.jpeg"
    ],
    "room_imgs":[
        "https://n3-q.mafengw.jpeg"
    ],
    "description":"酒店是一座假日酒店",
    "check_in_from":"14:00",
    "check_in_to":"18:00",
    "check_out_to":"12:00",
    "main_facs_include":[
        {
            "tag_id":"12342",
            "tag_name":"设施/服务名称"
        }
    ],
    "common_service_include":[
        {
            "tag_id":"23412",
            "tag_name":"设施/服务名称"
        }
    ],
    "hotel_service_include":[
        {
            "tag_id":"12323",
            "tag_name":"设施/服务名称"
        }
    ],
    "main_facs":[
        {
            "tag_id":"12342",
            "tag_name":"免费无线上网"
        }
    ],
    "hotel_service":[
        {
            "tag_id":"12323",
            "tag_name":"设施名称"
        }
    ],
    "common_service":[
        {
            "tag_id":"23412",
            "tag_name":"设施名称"
        }
    ],
    "room_list":[
        {
            "room_cid":"12",
            "zh_name":"精选套间",
            "foreign_name":"Deluxe Suite",
            "bed_type":"2张单人床",
            "size":"20-40",
            "imgs":[
                "https://dev-df.jpeg"
            ],
            "desc":"房型描述",
            "bed_params":[
                {
                    "bed_length":"2",
                    "bed_type":"1",
                    "bed_width":"1",
                    "quantity":"1"
                }
            ],
            "floor":"3-7",
            "adult_max":"2",
            "kid_max":"2",
            "child_policy":{
                "age":{
                    "min":"1",
                    "max":"2"
                },
                "height":{
                    "min":"120",
                    "max":"160"
                }
            },
            "add_bed_type":"1",
            "add_bed_desc":"加床说明",
            "allow_smoking":"1",
            "window":"1",
            "bathroom":"1",
            "reference_number":"11",
            "network":[
                {
                    "tag_id":"12342",
                    "tag_name":"免费无线上网"
                }
            ],
            "network_include":[
                {
                    "tag_id":"12342",
                    "tag_name":"设施/服务名称"
                }
            ],
            "room_service":[
                {
                    "tag_id":"12352",
                    "tag_name":"设施/服务名称"
                }
            ],
            "room_service_include":[
                {
                    "tag_id":"12352",
                    "tag_name":"设施/服务名称"
                }
            ],
            "meal_facs":[
                {
                    "tag_id":"12347",
                    "tag_name":"设施/服务名称"
                }
            ],
            "meal_facs_include":[
                {
                    "tag_id":"12347",
                    "tag_name":"设施/服务名称"
                }
            ],
            "bathroom_facs":[
                {
                    "tag_id":"34353",
                    "tag_name":"设施/服务名称"
                }
            ],
            "bathroom_facs_include":[
                {
                    "tag_id":"34353",
                    "tag_name":"设施/服务名称"
                }
            ],
            "room_facs":[
                {
                    "tag_id":"12134",
                    "tag_name":"设施/服务名称"
                }
            ],
            "room_facs_include":[
                {
                    "tag_id":"12134",
                    "tag_name":"设施/服务名称"
                }
            ],
            "entertainment_facs":[
                {
                    "tag_id":"34353",
                    "tag_name":"设施/服务名称"
                }
            ],
            "entertainment_facs_include":[
                {
                    "tag_id":"34353",
                    "tag_name":"设施/服务名称"
                }
            ],
            "special":[
                {
                    "tag_id":"12342",
                    "tag_name":"设施/服务名称"
                }
            ],
            "special_include":[
                {
                    "tag_id":"12342",
                    "tag_name":"34235"
                }
            ]
        }
    ]
}

异常错误码

异常码	异常信息
10110136	酒店资源不存在或不匹配
10110090	该酒店无房型信息
10110073	马蜂窝酒店未在商城注册
10110072	马蜂窝酒店不存在