文档中心 > API类目 > 飞猪-菲住联盟

alitrip.futurehotel.search.roomdetail (房型详情)

房型详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_room_detail_request RoomDetailRequest 可选 request
  • └ check_in_date
  • String
  • 可选
  • 2021-06-10
  • checkInDate
  • └ check_out_date
  • String
  • 可选
  • 2021-06-11
  • checkOutDate
  • └ hid
  • Number
  • 可选
  • 11111
  • 酒店id
  • └ login_user_id
  • String
  • 可选
  • 11
  • loginUserId
  • └ rid
  • Number
  • 可选
  • 1
  • 房型id
  • └ rooms
  • Number
  • 可选
  • 1
  • 房间数

响应参数

名称 类型 示例值 描述
result RoomDetailResponse result
  • └ fh_code
  • String
  • 1
  • fhCode
  • └ fh_msg
  • String
  • 1
  • fhMsg
  • └ fh_success
  • Boolean
  • 1
  • fhSuccess
  • room_v_o
  • RoomTypeHsfVo
  • []
  • 房型
  • └ add_bed
  • Number
  • 0
  • 是否可加床
  • └ area
  • String
  • 1
  • 区域
  • └ bed
  • String
  • 1张大床(1.5M)
  • 床型
  • └ bed_size
  • String
  • 1
  • 床数
  • └ brand_id
  • Number
  • 1
  • 品牌id
  • └ data_channel
  • Number
  • 1
  • 来源
  • └ extend
  • String
  • {}
  • extend
  • facility_list
  • Facility []
  • []
  • 房型设施服务
  • └ name
  • String
  • 卫浴
  • 名称
  • └ option_list
  • String []
  • 独立卫浴
  • 是否提供服务
  • └ floor
  • String
  • 3-4
  • 楼层
  • └ id
  • Number
  • 111111
  • id
  • └ max_occupancy
  • Number
  • 2
  • 最大入住人数
  • └ name
  • String
  • 单人间
  • 名称
  • └ name_e
  • String
  • e
  • 英文名称
  • └ network_service
  • String
  • 111
  • 网络服务
  • └ outer_room_id
  • String
  • 123
  • outerRoomId
  • pics
  • PicHsfVo []
  • []
  • 图片
  • └ head_image
  • Number
  • 1111
  • 头图
  • └ image_id
  • Number
  • 6345823108100274
  • 图片id
  • └ room_id
  • Number
  • 1
  • 房型id
  • └ room_name
  • String
  • 海景房
  • 房型名称
  • └ status
  • Number
  • 1
  • status
  • └ tag
  • Number
  • 1
  • 标签
  • └ upload_time
  • String
  • 2021-06-10 17:43:27
  • 上传时间
  • └ url
  • String
  • http://ha-public.oss-cn-hangzhou.aliyuncs.com/haproduct/6345823108100274.jpg
  • url
  • └ status
  • Number
  • 1
  • 状态
  • sub_rate_list
  • RateHsfVo []
  • []
  • 房价
  • └ active_tags
  • String []
  • 天天特惠
  • 营销活动标签
  • └ add_bed
  • Number
  • 1
  • 是否可加床
  • └ average_discount_amount
  • String
  • 10
  • 优惠金额
  • └ average_member_price
  • String
  • 100
  • 会员价
  • └ average_price
  • String
  • 100
  • 原价
  • └ average_sell_price
  • String
  • 100
  • 售价
  • └ base_price_ratio
  • String
  • 0.85
  • 底价比例
  • └ bed
  • String
  • 1张大床(1.5M)
  • 床型
  • └ bottom_price_flag
  • Number
  • 0
  • 是否底价模式
  • └ brand_member_discount
  • String
  • 92
  • 品牌会员折扣
  • └ breakfast_amount
  • Number
  • 1
  • 早餐
  • calendar_info_list
  • CalendarInfoHsf []
  • []
  • 日历价
  • └ activity_name
  • String
  • 天天特惠
  • 活动名称
  • └ alliance_member_price
  • String
  • 100
  • 会员价
  • └ base_price
  • String
  • 85
  • 底价
  • └ before_act_base_price
  • String
  • 100
  • 活动前售价
  • └ before_act_price
  • String
  • 100
  • 活动后售价
  • └ brand_member_price
  • String
  • 100
  • 品牌会员价
  • └ breakfast_amount
  • Number
  • 1
  • 早餐数
  • └ business_travel_price
  • String
  • 100
  • 差旅价
  • └ date
  • String
  • 2021-06-10
  • 日期
  • └ discount_price
  • String
  • 10
  • 优惠
  • └ dynamic_price
  • String
  • 100
  • 动态价
  • └ feizhu_points
  • String
  • 10
  • 菲住金
  • └ fliggy_member_discount
  • String
  • 100
  • 飞猪会员优惠
  • └ fliggy_member_price
  • String
  • 100
  • 飞猪会员价
  • inv_deduct_rules
  • InvDeductRules
  • {}
  • 库存
  • └ gen_inventory
  • Number
  • 1
  • 普通库存
  • └ gen_reserved_inv
  • Number
  • 1
  • 普通保留房
  • └ reserved_inv
  • Number
  • 1
  • 保留房
  • └ inventory
  • Number
  • 1
  • 库存
  • └ inventory_status
  • Number
  • 1
  • 库存开关
  • └ inventory_type
  • Number
  • 1
  • 库存类型
  • └ member_discount
  • String
  • 92
  • 会员折扣
  • └ merchant_activity_code
  • String
  • 111
  • 商家活动code
  • └ pay_price
  • String
  • 100
  • 支付金额
  • └ selling_price
  • String
  • 100
  • 售价
  • └ sub_activity_code
  • String
  • 1111
  • 子活动code
  • cancel_policy
  • CancelPolicy
  • {}
  • 退改签规则
  • ladder_policy_list
  • LadderPolicy []
  • []
  • 阶梯退规则
  • └ hours
  • String
  • 24
  • 小时
  • └ percentage
  • String
  • 30
  • 占比
  • └ type
  • Number
  • 3
  • 退改类型
  • └ cooperation_id
  • Number
  • 1
  • 合作商id
  • └ cooperation_name
  • String
  • 1
  • 合作商名称
  • └ data_channel
  • Number
  • 1
  • 来源
  • └ deadline_time
  • String
  • 2021-06-10 20:18:53
  • rp截止日期
  • discounts_info_list
  • DiscountsInfoHsfVo []
  • []
  • 优惠
  • └ benefit_create_channel
  • Number
  • 1
  • 活动权益出资方
  • └ benefit_id
  • Number
  • 1
  • 权益id
  • └ benefit_name
  • String
  • 天天特惠
  • 权益名称
  • └ benefit_type
  • Number
  • 1
  • 权益类型
  • └ discount_price
  • String
  • 10
  • 优惠金额
  • └ marketing_tag
  • String
  • 2204103009798_1623295821131_13
  • 优惠标签
  • └ name
  • String
  • 天天特惠
  • 优惠名称
  • └ ebk_gid
  • Number
  • 1
  • ebkGid
  • └ ebk_rate_id
  • Number
  • 1
  • ebkRateId
  • └ ebk_rate_plan_id
  • Number
  • 1
  • ebkRatePlanId
  • └ effective_time
  • String
  • 2021-06-10 20:18:53
  • 生效时间
  • └ end_time_daily
  • String
  • 2021-06-10 20:18:53
  • 每日结束时间
  • feizhu_disc_info_list
  • DiscountsInfoHsfVo []
  • []
  • 红包返现优惠详情
  • └ benefit_create_channel
  • Number
  • 1
  • 优惠出资方
  • └ benefit_id
  • Number
  • 1
  • 权益id
  • └ benefit_name
  • String
  • 天天特惠
  • 权益名称
  • └ benefit_type
  • Number
  • 1
  • 权益类型
  • └ discount_price
  • String
  • 10
  • 优惠金额
  • └ marketing_tag
  • String
  • 天天特惠
  • 营销标签
  • └ name
  • String
  • 天天特惠
  • 优惠名称
  • └ feizhu_points
  • String
  • 10
  • 菲住金
  • └ filter_tags
  • String []
  • 11
  • 页面房型筛选标签
  • └ fliggy_member_discount
  • String
  • 10
  • 飞猪会员优惠
  • └ hotel_id
  • Number
  • 1
  • 酒店id
  • └ hotel_name
  • String
  • 测试酒店
  • 酒店名称
  • └ id
  • Number
  • 12
  • 报价id
  • └ inventory
  • Number
  • 1
  • 库存
  • └ inventory_type_flag
  • Number
  • 1
  • 库存类型
  • └ meals
  • Number []
  • 1
  • 餐食
  • └ member_discount
  • String
  • 1
  • 会员优惠
  • └ member_discount_amount
  • String
  • 1
  • 会员优惠总数
  • └ name
  • String
  • 特价
  • 报价名称
  • └ occupancy
  • Number
  • 2
  • occupancy
  • └ outer_room_id
  • String
  • 1
  • outerRoomId
  • └ presentation
  • Number
  • 1
  • presentation
  • price_detail
  • PriceDetailVo
  • {}
  • 价格详情
  • details
  • DatePriceDetailVo []
  • []
  • 价格日历明细
  • └ date
  • String
  • 2021-06-10
  • 日期
  • └ meals
  • Number
  • 1
  • 餐食
  • └ price
  • String
  • 100
  • 价格
  • └ rooms
  • String
  • 1
  • 房间
  • └ discount
  • Number
  • 92
  • 折扣
  • └ discount_amount
  • String
  • 10
  • 优惠
  • └ member_level
  • Number
  • 1
  • 会员等级
  • └ nights
  • String
  • 1
  • 间夜
  • └ rooms
  • String
  • 1
  • 房间数
  • └ total_feizhu_points
  • String
  • 1
  • 菲住金
  • └ total_member_price
  • String
  • 100
  • 会员价
  • └ total_price
  • String
  • 100
  • 原价
  • └ total_sell_price
  • String
  • 100
  • 售价
  • └ price_monitor
  • Boolean
  • true
  • priceMonitor
  • └ room_id
  • Number
  • 1
  • 房型id
  • └ room_name
  • String
  • 海景房
  • 房型名称
  • └ rp_id
  • Number
  • 123
  • rpid
  • └ rp_name
  • String
  • 特价
  • rp名称
  • └ rp_name_e
  • String
  • w
  • rp英文名称
  • └ start_time_daily
  • String
  • 2021-06-10 06:30:00
  • 每日开始时间
  • └ status
  • Number
  • 1
  • 状态
  • └ taobao_outer_id
  • String
  • 11
  • taobaoOuterId
  • └ theme_activity_benefit_id
  • Number
  • 11
  • 主题活动id
  • └ theme_activity_tag
  • String
  • 会员日
  • 主题活动标签
  • └ theme_benefit_type
  • Number
  • 1
  • 主题活动类型
  • └ theme_marketing_tag
  • String
  • 会员日88折
  • 主题活动营销标签
  • └ union_hotel_id
  • Number
  • 11
  • unionHotelId
  • └ use_feizhu_points
  • Number
  • 1
  • 是否可使用菲住金
  • └ use_fliggy_market
  • Boolean
  • true
  • 是否使用菲住活动
  • └ use_room_inv
  • Boolean
  • false
  • 是否使用room库存
  • └ vendor
  • Number
  • 1
  • 来源
  • └ version
  • Number
  • 1
  • 版本号
  • └ window_type
  • Number
  • 1
  • 窗型
  • └ tags
  • String
  • 111
  • 标签
  • └ window_type
  • Number
  • 1
  • 窗型
  • └ window_type_desc
  • String
  • 有窗
  • 窗型描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFuturehotelSearchRoomdetailRequest req = new AlitripFuturehotelSearchRoomdetailRequest();
AlitripFuturehotelSearchRoomdetailRequest.RoomDetailRequest obj1 = new AlitripFuturehotelSearchRoomdetailRequest.RoomDetailRequest();
obj1.setCheckInDate("2021-06-10");
obj1.setCheckOutDate("2021-06-11");
obj1.setHid(11111L);
obj1.setLoginUserId("11");
obj1.setRid(1L);
obj1.setRooms(1L);
req.setParamRoomDetailRequest(obj1);
AlitripFuturehotelSearchRoomdetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_futurehotel_search_roomdetail_response>
    <result>
        <fh_code>1</fh_code>
        <fh_msg>1</fh_msg>
        <fh_success>1</fh_success>
        <room_v_o>
            <add_bed>0</add_bed>
            <area>1</area>
            <bed>1张大床(1.5M)</bed>
            <bed_size>1</bed_size>
            <brand_id>1</brand_id>
            <data_channel>1</data_channel>
            <extend>{}</extend>
            <facility_list>
                <facility>
                    <name>卫浴</name>
                    <option_list>
                        <string>独立卫浴</string>
                    </option_list>
                </facility>
            </facility_list>
            <floor>3-4</floor>
            <id>111111</id>
            <max_occupancy>2</max_occupancy>
            <name>单人间</name>
            <name_e>e</name_e>
            <network_service>111</network_service>
            <outer_room_id>123</outer_room_id>
            <pics>
                <pic_hsf_vo>
                    <head_image>1111</head_image>
                    <image_id>6345823108100274</image_id>
                    <room_id>1</room_id>
                    <room_name>海景房</room_name>
                    <status>1</status>
                    <tag>1</tag>
                    <upload_time>2021-06-10 17:43:27</upload_time>
                    <url>http://ha-public.oss-cn-hangzhou.aliyuncs.com/haproduct/6345823108100274.jpg</url>
                </pic_hsf_vo>
            </pics>
            <status>1</status>
            <sub_rate_list>
                <rate_hsf_vo>
                    <active_tags>
                        <string>天天特惠</string>
                    </active_tags>
                    <add_bed>1</add_bed>
                    <average_discount_amount>10</average_discount_amount>
                    <average_member_price>100</average_member_price>
                    <average_price>100</average_price>
                    <average_sell_price>100</average_sell_price>
                    <base_price_ratio>0.85</base_price_ratio>
                    <bed>1张大床(1.5M)</bed>
                    <bottom_price_flag>0</bottom_price_flag>
                    <brand_member_discount>92</brand_member_discount>
                    <breakfast_amount>1</breakfast_amount>
                    <calendar_info_list>
                        <calendar_info_hsf>
                            <activity_name>天天特惠</activity_name>
                            <alliance_member_price>100</alliance_member_price>
                            <base_price>85</base_price>
                            <before_act_base_price>100</before_act_base_price>
                            <before_act_price>100</before_act_price>
                            <brand_member_price>100</brand_member_price>
                            <breakfast_amount>1</breakfast_amount>
                            <business_travel_price>100</business_travel_price>
                            <date>2021-06-10</date>
                            <discount_price>10</discount_price>
                            <dynamic_price>100</dynamic_price>
                            <feizhu_points>10</feizhu_points>
                            <fliggy_member_discount>100</fliggy_member_discount>
                            <fliggy_member_price>100</fliggy_member_price>
                            <inv_deduct_rules>
                                <gen_inventory>1</gen_inventory>
                                <gen_reserved_inv>1</gen_reserved_inv>
                                <reserved_inv>1</reserved_inv>
                            </inv_deduct_rules>
                            <inventory>1</inventory>
                            <inventory_status>1</inventory_status>
                            <inventory_type>1</inventory_type>
                            <member_discount>92</member_discount>
                            <merchant_activity_code>111</merchant_activity_code>
                            <pay_price>100</pay_price>
                            <selling_price>100</selling_price>
                            <sub_activity_code>1111</sub_activity_code>
                        </calendar_info_hsf>
                    </calendar_info_list>
                    <cancel_policy>
                        <ladder_policy_list>
                            <ladder_policy>
                                <hours>24</hours>
                                <percentage>30</percentage>
                            </ladder_policy>
                        </ladder_policy_list>
                        <type>3</type>
                    </cancel_policy>
                    <cooperation_id>1</cooperation_id>
                    <cooperation_name>1</cooperation_name>
                    <data_channel>1</data_channel>
                    <deadline_time>2021-06-10 20:18:53</deadline_time>
                    <discounts_info_list>
                        <discounts_info_hsf_vo>
                            <benefit_create_channel>1</benefit_create_channel>
                            <benefit_id>1</benefit_id>
                            <benefit_name>天天特惠</benefit_name>
                            <benefit_type>1</benefit_type>
                            <discount_price>10</discount_price>
                            <marketing_tag>2204103009798_1623295821131_13</marketing_tag>
                            <name>天天特惠</name>
                        </discounts_info_hsf_vo>
                    </discounts_info_list>
                    <ebk_gid>1</ebk_gid>
                    <ebk_rate_id>1</ebk_rate_id>
                    <ebk_rate_plan_id>1</ebk_rate_plan_id>
                    <effective_time>2021-06-10 20:18:53</effective_time>
                    <end_time_daily>2021-06-10 20:18:53</end_time_daily>
                    <feizhu_disc_info_list>
                        <discounts_info_hsf_vo>
                            <benefit_create_channel>1</benefit_create_channel>
                            <benefit_id>1</benefit_id>
                            <benefit_name>天天特惠</benefit_name>
                            <benefit_type>1</benefit_type>
                            <discount_price>10</discount_price>
                            <marketing_tag>天天特惠</marketing_tag>
                            <name>天天特惠</name>
                        </discounts_info_hsf_vo>
                    </feizhu_disc_info_list>
                    <feizhu_points>10</feizhu_points>
                    <filter_tags>
                        <string>11</string>
                    </filter_tags>
                    <fliggy_member_discount>10</fliggy_member_discount>
                    <hotel_id>1</hotel_id>
                    <hotel_name>测试酒店</hotel_name>
                    <id>12</id>
                    <inventory>1</inventory>
                    <inventory_type_flag>1</inventory_type_flag>
                    <meals>
                        <number>1</number>
                    </meals>
                    <member_discount>1</member_discount>
                    <member_discount_amount>1</member_discount_amount>
                    <name>特价</name>
                    <occupancy>2</occupancy>
                    <outer_room_id>1</outer_room_id>
                    <presentation>1</presentation>
                    <price_detail>
                        <details>
                            <date_price_detail_vo>
                                <date>2021-06-10</date>
                                <meals>1</meals>
                                <price>100</price>
                                <rooms>1</rooms>
                            </date_price_detail_vo>
                        </details>
                        <discount>92</discount>
                        <discount_amount>10</discount_amount>
                        <member_level>1</member_level>
                        <nights>1</nights>
                        <rooms>1</rooms>
                        <total_feizhu_points>1</total_feizhu_points>
                        <total_member_price>100</total_member_price>
                        <total_price>100</total_price>
                        <total_sell_price>100</total_sell_price>
                    </price_detail>
                    <price_monitor>true</price_monitor>
                    <room_id>1</room_id>
                    <room_name>海景房</room_name>
                    <rp_id>123</rp_id>
                    <rp_name>特价</rp_name>
                    <rp_name_e>w</rp_name_e>
                    <start_time_daily>2021-06-10 06:30:00</start_time_daily>
                    <status>1</status>
                    <taobao_outer_id>11</taobao_outer_id>
                    <theme_activity_benefit_id>11</theme_activity_benefit_id>
                    <theme_activity_tag>会员日</theme_activity_tag>
                    <theme_benefit_type>1</theme_benefit_type>
                    <theme_marketing_tag>会员日88折</theme_marketing_tag>
                    <union_hotel_id>11</union_hotel_id>
                    <use_feizhu_points>1</use_feizhu_points>
                    <use_fliggy_market>true</use_fliggy_market>
                    <use_room_inv>false</use_room_inv>
                    <vendor>1</vendor>
                    <version>1</version>
                    <window_type>1</window_type>
                </rate_hsf_vo>
            </sub_rate_list>
            <tags>111</tags>
            <window_type>1</window_type>
            <window_type_desc>有窗</window_type_desc>
        </room_v_o>
    </result>
</alitrip_futurehotel_search_roomdetail_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部