AI 开放平台接入文档

途牛AI开放平台接入文档


酒店套餐列表查询

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>酒店套餐列表查询接口</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://openapi.tuniu.cn/hts/agent/package/hotel/list</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>城市code</td> <td>cityCode</td> <td>String</td> <td>是</td> <td>与cityName必传1个</td> </tr> <tr> <td>城市名称</td> <td>cityName</td> <td>String</td> <td>是</td> <td>与cityName必传1个</td> </tr> <tr> <td>行程天数</td> <td>journeyNum</td> <td>String</td> <td>否</td> <td>默认1,代表2天1晚</td> </tr> <tr> <td>入住日期</td> <td>checkIn</td> <td>String</td> <td>否</td> <td>优先客户指定日期默认当天+1</td> </tr> <tr> <td>离店日期</td> <td>checkOut</td> <td>String</td> <td>否</td> <td>默认入住日期+1</td> </tr> <tr> <td>poi名称</td> <td>poiName</td> <td>String</td> <td>否</td> <td>用户输入地点时传输,未输入时为空;用户输入地点时,需要按照该地点范围内4公里范围内查询酒店列表,排序按照默认推荐排序规则;</td> </tr> <tr> <td>关键词</td> <td>keyword</td> <td>String</td> <td>否</td> <td>多个关键词时,用&quot; &quot;空格隔开</td> </tr> <tr> <td>价格范围</td> <td>prices</td> <td>String</td> <td>否</td> <td>1. 传固定值时,例如300,接口按照250-350的范围取值;左-50,右+50。2. 传范围时,例如300-500,接口按照300-500的范围取值;</td> </tr> <tr> <td>每页条数</td> <td>pageSize</td> <td>Integer</td> <td>否</td> <td>默认配置条数</td> </tr> <tr> <td>页码</td> <td>pageNum</td> <td>Integer</td> <td>否</td> <td>默认1</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code class="language-json">{ &amp;quot;cityName&amp;quot;: &amp;quot;南京&amp;quot;, &amp;quot;pageSize&amp;quot;: 32 }</code></pre> <h5>返回参数</h5> <table> <thead> <tr> <th>字段名称</th> <th>字段编码</th> <th>字段类型</th> <th>非空</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>是否成功</td> <td>success</td> <td>Boolean</td> <td>是</td> </tr> <tr> <td>状态码</td> <td>errorCode</td> <td>Integer</td> <td>是</td> </tr> <tr> <td>返回结果</td> <td>data</td> <td>Data</td> <td>否</td> </tr> </tbody> </table> <p>Data</p> <table> <thead> <tr> <th>字段名称</th> <th>字段编码</th> <th>字段类型</th> <th>非空</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>快照id</td> <td>queryId</td> <td>String</td> <td>是</td> <td>快照id 首次查询返回</td> </tr> <tr> <td>总页数</td> <td>totalPageNum</td> <td>Integer</td> <td>是  </td> </tr> <tr> <td>数量</td> <td>count</td> <td>Integer</td> <td>是  </td> </tr> <tr> <td>套餐列表</td> <td>rows</td> <td>List&lt;PackageHotel&gt;</td> <td>否</td> </tr> </tbody> </table> <p>PackageHotel</p> <table> <thead> <tr> <th>字段名称</th> <th>字段编码</th> <th>字段类型</th> <th>非空</th> <th> </th> </tr> </thead> <tbody> <tr> <td>首图</td> <td>firstPic</td> <td>String</td> <td>否</td> <td> </td> </tr> <tr> <td>行程天数</td> <td>journeyNum</td> <td>Integer</td> <td>否</td> <td> </td> </tr> <tr> <td>套餐id</td> <td>packageId</td> <td>String</td> <td>否</td> <td> </td> </tr> <tr> <td>套餐价格</td> <td>packagePrice</td> <td>Double</td> <td>否</td> <td> </td> </tr> <tr> <td>点评分数</td> <td>commentScore</td> <td>Double</td> <td>否</td> <td> </td> </tr> <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>房型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>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>starName</td> <td>String</td> <td>否</td> <td> </td> </tr> <tr> <td>城市code</td> <td>cityCode</td> <td>Integer</td> <td>否</td> <td> </td> </tr> <tr> <td>城市名称</td> <td>cityName</td> <td>String</td> <td>否</td> <td> </td> </tr> <tr> <td>套餐名称</td> <td>packageName</td> <td>String</td> <td>否</td> <td> </td> </tr> <tr> <td>套餐子项</td> <td>packageItemList</td> <td>List&lt;PackageItem&gt;</td> <td>否</td> <td> </td> </tr> </tbody> </table> <p>PackageItem</p> <table> <thead> <tr> <th>字段名称</th> <th>字段编码</th> <th>字段类型</th> <th>非空</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>套餐子项类型</td> <td>itemType</td> <td>String</td> <td>否</td> <td>BREAKFAST/OTHERS...</td> </tr> <tr> <td>套餐子项名称</td> <td>itemName</td> <td>String</td> <td>否</td> <td>早餐/芳草地首日精美欢迎水果</td> </tr> <tr> <td>套餐子项数量</td> <td>quantity</td> <td>Integer</td> <td>否</td> <td>数量</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ &amp;quot;success&amp;quot;: true, &amp;quot;errorCode&amp;quot;: 590000, &amp;quot;data&amp;quot;: { &amp;quot;queryId&amp;quot;: &amp;quot;8E6789E41BEAC627&amp;quot;, &amp;quot;totalPageNum&amp;quot;: 2, &amp;quot;count&amp;quot;: 16, &amp;quot;rows&amp;quot;: [ { &amp;quot;firstPic&amp;quot;: &amp;quot;http://m.tuniucdn.com/fb3/s1/2n9c/2ec6KFiTPiWsnTbLaSMotfhtBo7E.jpg&amp;quot;, &amp;quot;journeyNum&amp;quot;: 2, &amp;quot;packageId&amp;quot;: &amp;quot;2107327678&amp;quot;, &amp;quot;packagePrice&amp;quot;: 778.0, &amp;quot;commentScore&amp;quot;: 4.0, &amp;quot;hotelId&amp;quot;: 2073755245, &amp;quot;hotelName&amp;quot;: &amp;quot;南京高淳域见芳草地度假酒店&amp;quot;, &amp;quot;roomId&amp;quot;: 2074237382, &amp;quot;roomName&amp;quot;: &amp;quot;芳草地大床房&amp;quot;, &amp;quot;checkIn&amp;quot;: &amp;quot;2024-12-22&amp;quot;, &amp;quot;starName&amp;quot;: &amp;quot;四钻&amp;quot;, &amp;quot;cityCode&amp;quot;: &amp;quot;1602&amp;quot;, &amp;quot;cityName&amp;quot;: &amp;quot;南京&amp;quot;, &amp;quot;packageName&amp;quot;: &amp;quot;芳草地大床房3天2晚套餐&amp;quot;, &amp;quot;checkOut&amp;quot;: &amp;quot;2024-12-24&amp;quot;, &amp;quot;packageItemList&amp;quot;: [ { &amp;quot;itemType&amp;quot;: &amp;quot;BREAKFAST&amp;quot;, &amp;quot;itemName&amp;quot;: &amp;quot;早餐&amp;quot;, &amp;quot;quantity&amp;quot;: 2 }, { &amp;quot;itemType&amp;quot;: &amp;quot;OTHERS&amp;quot;, &amp;quot;itemName&amp;quot;: &amp;quot;芳草地首日精美欢迎水果&amp;quot;, &amp;quot;quantity&amp;quot;: 1 } ] } ] } }</code></pre>

页面列表

ITEM_HTML