酒店详情查询
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>酒店详情查询接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://platform.tuniu.cn/hts/agent/hotel/detail</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th> 字段名称</th>
<th>字段编码</th>
<th>字段类型</th>
<th>是否必填</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>酒店id</td>
<td>hotelId</td>
<td>Long</td>
<td>与 hotelName 必传一个</td>
<td>与 hotelName 必传一个</td>
</tr>
<tr>
<td>酒店名称</td>
<td>hotelName</td>
<td>String</td>
<td>与 hotelId 必传一个</td>
<td>与 hotelId 必传一个</td>
</tr>
<tr>
<td>入住日期</td>
<td>checkIn</td>
<td>String</td>
<td>否</td>
<td>默认第二天</td>
</tr>
<tr>
<td>离店日期</td>
<td>checkOut</td>
<td>String</td>
<td>否</td>
<td>默认第三天</td>
</tr>
<tr>
<td>房间数量</td>
<td>roomNum</td>
<td>Integer</td>
<td>否</td>
<td>默认1间房</td>
</tr>
<tr>
<td>成人数量</td>
<td>adultNum</td>
<td>Integer</td>
<td>否</td>
<td>默认2成人</td>
</tr>
<tr>
<td>儿童数量</td>
<td>childNum</td>
<td>Integer</td>
<td>否</td>
<td>默认0儿童</td>
</tr>
<tr>
<td>儿童年龄</td>
<td>childAges</td>
<td>List<Integer></td>
<td>否</td>
<td>对应儿童数</td>
</tr>
<tr>
<td>套餐</td>
<td>onlyPackagePrice</td>
<td>String</td>
<td>否</td>
<td>默认false, 为true时只返回有套餐的报价（酒套使用）</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-json">{
&quot;hotelId&quot;: 84870,
&quot;hotelName&quot;: &quot;三亚国光豪生度假酒店&quot;,
&quot;checkIn&quot;: &quot;2025-03-18&quot;,
&quot;checkOut&quot;: &quot;2025-03-19&quot;,
&quot;roomNum&quot;: 1,
&quot;adultNum&quot;: 2,
&quot;childNum&quot;: 1,
&quot;childAges&quot;: [
2
],
&quot;onlyPackagePrice&quot;: false
}</code></pre>
<h5>返回参数</h5>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段编码</th>
<th>字段类型</th>
<th>非空</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>酒店id</td>
<td>hotelid</td>
<td>Long</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>酒店名称</td>
<td>hotelName</td>
<td>String</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>入住日期</td>
<td>checkIn</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>离店日期</td>
<td>checkOut</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>房间数量</td>
<td>roomNum</td>
<td>Integer</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>成人数</td>
<td>adultNum</td>
<td>Integer</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>儿童数</td>
<td>childNum</td>
<td>Integer</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>是否国内酒店</td>
<td>domestic</td>
<td>Boolen</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>房间</td>
<td>rooms</td>
<td>List<Room></td>
<td>否</td>
<td>房型及房型报价</td>
</tr>
</tbody>
</table>
<p>Room</p>
<table>
<thead>
<tr>
<th><strong>字段名称</strong></th>
<th><strong>字段编码</strong></th>
<th><strong>类型</strong></th>
<th><strong>非空</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>房型id</td>
<td>roomId</td>
<td>Long</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>房型名称</td>
<td>roomName</td>
<td>String</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>房间面积</td>
<td>area</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>房间楼层</td>
<td>floor</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>床型</td>
<td>bedTypeName</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>床型大小</td>
<td>bedSize</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>窗型</td>
<td>window</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>吸烟情况</td>
<td>smoking</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>房间数量</td>
<td>roomCount</td>
<td>Integer</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>房间图片</td>
<td>firstPic</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>报价信息</td>
<td>ratePlans</td>
<td>List<RatePlan></td>
<td>是</td>
<td> </td>
</tr>
</tbody>
</table>
<p>RatePlan</p>
<table>
<thead>
<tr>
<th><strong>字段名称</strong></th>
<th><strong>字段编码</strong></th>
<th><strong>类型</strong></th>
<th><strong>非空</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>价格</td>
<td>rmbPrices</td>
<td>String</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>补充验价接口参数</td>
<td>preBookParam</td>
<td>String</td>
<td>是</td>
<td>/hts/agent/hotel/book/param补充验价接口需要的参数 实现预定页跳转</td>
</tr>
<tr>
<td>报价名称</td>
<td>ratePlanName</td>
<td>String</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>报价id</td>
<td>vendorRatePlanId</td>
<td>String</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>餐食</td>
<td>mealText</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>取消描述</td>
<td>cancelDesc</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>取消规则类型</td>
<td>cancelText</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>报价库存</td>
<td>count</td>
<td>Integer</td>
<td>是</td>
<td> </td>
</tr>
<tr>
<td>套餐信息</td>
<td>packageInfo</td>
<td>PackageInfo</td>
<td>否</td>
<td> </td>
</tr>
</tbody>
</table>
<p>PackageInfo</p>
<table>
<thead>
<tr>
<th><strong>字段名称</strong></th>
<th><strong>字段编码</strong></th>
<th><strong>类型</strong></th>
<th><strong>非空</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>套餐名称</td>
<td>packageName</td>
<td>String</td>
<td>否</td>
</tr>
<tr>
<td>套餐描述</td>
<td>packageDesc</td>
<td>String</td>
<td>否</td>
</tr>
<tr>
<td>套餐子项明细</td>
<td>packageItemList</td>
<td>List<PackageItem></td>
<td>否</td>
</tr>
</tbody>
</table>
<p>PackageItem</p>
<table>
<thead>
<tr>
<th><strong>字段名称</strong></th>
<th><strong>字段编码</strong></th>
<th><strong>类型</strong></th>
<th><strong>非空</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>套餐子项类型</td>
<td>itemTypeName</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>套餐子项名称</td>
<td>itemName</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>套餐有效期说明</td>
<td>itemValidDesc</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>赠送方式</td>
<td>giveType</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>套餐使用方式</td>
<td>entryMode</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>使用规则</td>
<td>useRuleList</td>
<td>List<String></td>
<td>否</td>
<td> </td>
</tr>
<tr>
<td>使用地址</td>
<td>saddress</td>
<td>String</td>
<td>否</td>
<td> </td>
</tr>
</tbody>
</table>
<h5>返参示例</h5>
<pre><code class="language-json"> {
&quot;successCode&quot;: true,
&quot;msg&quot;: &quot;OK&quot;,
&quot;hotelId&quot;: 84870,
&quot;hotelName&quot;: &quot;三亚国光豪生度假酒店&quot;,
&quot;checkIn&quot;: &quot;2025-03-13&quot;,
&quot;checkOut&quot;: &quot;2025-03-14&quot;,
&quot;roomNum&quot;: 1,
&quot;adultNum&quot;: 2,
&quot;childNum&quot;: 0,
&quot;domestic&quot;: true,
&quot;rooms&quot;: [
{
&quot;roomId&quot;: 1890845876,
&quot;roomName&quot;: &quot;休闲双床房&quot;,
&quot;area&quot;: &quot;57㎡&quot;,
&quot;floor&quot;: &quot;1-7层&quot;,
&quot;bedTypeName&quot;: &quot;未知床型&quot;,
&quot;bedSize&quot;: &quot;&quot;,
&quot;window&quot;: &quot;有窗&quot;,
&quot;smoking&quot;: &quot;不能抽烟&quot;,
&quot;roomCount&quot;: 30,
&quot;firstPic&quot;: &quot;https://m.tuniucdn.com/fb3/s1/2n9c/boimw2UkUmBEfobUMEE2QhTT2VV_w180_h180_c1_t0_q70.jpg&quot;,
&quot;ratePlans&quot;: [
{
&quot;rmbPrices&quot;: &quot;700.0&quot;,
&quot;preBookParam&quot;: &quot;272867A3C15C82204D11FF103032BB6B&quot;,
&quot;packageInfo&quot;: {
&quot;packageName&quot;: &quot;2张100元SPA代金券+章鱼部落乐玩家活动+铂爵旅拍+cdf中免礼遇&quot;,
&quot;packageDesc&quot;: null,
&quot;packageItemList&quot;: [
{
&quot;itemTypeName&quot;: &quot;礼品&quot;,
&quot;itemName&quot;: &quot;cdf中免礼遇&quot;,
&quot;itemValidDesc&quot;: &quot;离店后3日失效&quot;,
&quot;giveType&quot;: &quot;只赠送一次&quot;,
&quot;entryMode&quot;: &quot;凭确认短信直接入园&quot;,
&quot;useRuleList&quot;: [
&quot;2名成人，&quot;
],
&quot;saddress&quot;: &quot;&quot;
}
]
},
&quot;ratePlanName&quot;: &quot;(官方直销网红泳池带娃爱住)&quot;,
&quot;vendorRatePlanId&quot;: &quot;4472942_2680982_757370985&quot;,
&quot;mealText&quot;: &quot;无早餐&quot;,
&quot;cancelDesc&quot;: &quot;如未入住或取消及提前离店，途牛将收取¥700.0支付酒店。&quot;,
&quot;cancelText&quot;: &quot;不可取消&quot;,
&quot;count&quot;: 99
}
]
}
]
}</code></pre>