悦想家
首页
V1版本
数据字典
数据字典
  • 省市
  • 酒店服务设施
  • 房型服务设施
  • 酒店品牌
首页
V1版本
数据字典
数据字典
  • 省市
  • 酒店服务设施
  • 房型服务设施
  • 酒店品牌
  1. 首页
  • Release Notes
  • 签名认证
  • 错误码
  • 一、分销商对接流程图
  • 二、酒店静态信息类接口
    • 2.0说明
    • 2.1城市code获取酒店ID
      POST
    • 2.2酒店分页查询
      POST
    • 2.3获取酒店详情
      POST
    • 2.4获取酒店房型
      POST
  • 三、价格类接口
    • 3.1按照区/县获取酒店起售价
      POST
    • 3.2获取酒店产品列表
      POST
    • 3.4获取酒店实时可订产品列表
      POST
    • 3.5可预订产品房态
      POST
    • 3.6条件搜索酒店接口
      POST
  • 四、订单类接口
    • 4.1预下单校验
      POST
    • 4.2下单接口
      POST
    • 4.3确认订单支付
      POST
    • 4.4查询订单详情
      POST
    • 4.5取消订单
      POST
    • 4.6建售后单
      POST
    • 4.7查售后单
      POST
  • 五、监测类接口
    • 5.1检测酒店房型变更
      POST
    • 5.2监测订单状态
      POST
  • 六、推送类接口
  1. 首页

Release Notes

v1.0.9——20260116#

文档#

添加酒店搜索接口

二、酒店静态信息类接口#

3.6 酒店搜索接口 具体参考文档

v1.0.8——20250613#

文档#

修改

四、订单类接口#

4.1 预下单校验
预下单请求参数新增每日价格
预下单返回code新增50002
4.2 下单校验
下单请求参数新增每日价格

v1.0.7——20250221#

文档#

修改 最低价返回数据结构

三、价格类接口#

3.1 响应参数变动 结构以列表形式返回每天的最低价 具体参考文档

v1.0.6——20250115#

文档#

新增 签名认证 文档

三、价格类接口#

3.5可预定产品房态 响应参数 增加date 注释 日期yyyy-MM-dd

v1.0.5——20250114#

四、订单类接口#

4.1预下单校验 响应参数 变更code 注释 0.成功;50001 产品价格变化

v1.0.4——20250110#

四、订单类接口#

4.5取消订单 响应参数 变更code 注释 0.取消成功;1.取消中;2.取消失败;3.订单号不存在

v1.0.3——20250108#

二、酒店静态信息类接口#

2.4获取酒店房型 响应参数 变更 roomSize 房间大小改为必填,默认0为空值

三、价格类接口#

3.4获取酒店实时可订产品列表 响应参数 增加 roomSize 房间大小改为必填,默认0为空值

v1.0.2——20241226#

四、订单类接口#

4.1预下单校验 请求参数 增加 totalPrice 订单金额(非必填)字段
4.2下单接口 请求参数 增加 totalPrice 订单金额(非必填)字段

v1.0.1——20241223#

二、静态类接口#

2.3获取酒店详情 响应参数 levelNum 酒店星级枚举字典调整
2.4获取酒店房型 响应参数 bedType 增加枚举类RANDOM-酒店随机安排床型

三、价格类接口#

3.5 可预定产品房态 响应参数 同步原文档

v1.0.1——20241203#

文档#

新增 修订记录
新增 错误码文档
新增 数据字典下载链接

二、静态类接口#

2.2酒店分页查询 响应参数 新增 hotelPinyin 酒店名全称(非必填)
2.2酒店分页查询 响应参数 新增 status 状态 ENABLED 有效 DISABLED无效(必填)
2.2酒店分页查询 响应参数 新增 hotelTheme 酒店主题json字符串
2.2酒店分页查询 响应参数 新增 hotelThemes 酒店主题Vo数组
2.3获取酒店详情 响应参数 新增 coordinateList 酒店坐标信息
2.3获取酒店详情 响应参数 变更 brandName 为 category 酒店类别名称(文档更正)

三、价格类接口#

3.4实时可定产品 响应参数 新增 roomCancelRuleList/roomProductId 状态
3.4实时可定产品 响应参数 新增 roomCancelRuleList/cancelType 状态
3.4实时可定产品 响应参数 新增 roomSaleStatusList/productRoomId 状态

四、订单类接口#

4.1预备下单校验接口 响应参数 调整追加额外返回字段!!!
4.2下单接口 响应参数 调整 追加额外返回字段!!!
4.3确认订单 响应参数 调整 code 为int(文档更正)
4.3确认订单 响应参数 调整 msg 为非必填(文档更正)
4.4订单详情 响应参数 新增 hotelOrderRoomList/idcard 证件号
4.4订单详情 响应参数 新增 hotelOrderRoomList/telephone 联系电话
4.4订单详情 响应参数 新增 hotelOrderRoomList/checkStatus 入住状态
4.4订单详情 响应参数 新增 hotelOrderRoomList/checkoutType 离店类型
4.4订单详情 响应参数 新增 hotelOrderRoomList/createTime 创建时间
4.4订单详情 响应参数 新增 hotelOrderRoomList/settleStatus 结算状态
4.4订单详情 响应参数 新增 hotelOrderRoomList/actualTotalAmount 最终订单金额
4.4订单详情 响应参数 新增 hotelOrderRoomList/breakfast 早餐数量
4.4订单详情 响应参数 新增 hotelOrderCancelRuleList 房型产品取消规则List
4.5取消订单 响应参数 调整 refundAmount 售后退款金额 为number类型
4.6查售后单 响应参数 调整 msg 为非必填(文档更正)
4.6查售后单 响应参数 调整 msg 为非必填(文档更正)

五、检测类接口#

5.1监测酒店及房型 响应参数 新增 current 当前页(文档更正)
5.1监测酒店及房型 响应参数 新增 size 页大小(文档更正)
5.1监测酒店及房型 响应参数 新增 pages 总页数(文档更正)
修改于 2026-01-16 05:15:52
下一页
签名认证
Built with