总览 / 业务域 / 酒店

酒店 业务总览

酒店与房型、价格日历、订单、点评

178接口数
68已确认在用
23子域
22免鉴权接口
3缺摘要
25涉及数据表
要看接口明细:酒店 接口清单 →(默认只显示契约,调用链与示例折叠;每页最多 46 个接口)

这个域里有哪些业务对象

子域 / 业务对象接口在用代表接口控制器
会员出行人60addHotelMemberTraveler deleteHotelMemberTraveler getHotelMemberTraveler queryHotelMemberTravelerList …共 6 个HotelMemberTravelerController
对外酒店接口2117getHotelCalendar getHotelInfo getHotelOrder getHotelOrderDetail …共 21 个HotelApiController
房型1110addHotelRoomType deleteHotelRoomType getHotelRoomType getHotelRoomTypeMaxSort …共 11 个HotelRoomTypeController
房型·计划60addHotelRoomTypePlan deleteHotelRoomTypePlan getHotelRoomTypePlan queryHotelRoomTypePlanList …共 6 个HotelRoomTypePlanController
房间·价格·日历95addHotelRoomPriceCalendar batchUpdateRoomPriceCalendar batchUpdateRoomPriceCalendarStatus deleteHotelRoomPriceCalendar …共 9 个HotelRoomPriceCalendarController
房间属性60addHotelRoomAttr deleteHotelRoomAttr getHotelRoomAttr queryHotelRoomAttrList …共 6 个HotelRoomAttrController
房间属性·关联60addHotelRoomAttrRel deleteHotelRoomAttrRel getHotelRoomAttrRel queryHotelRoomAttrRelList …共 6 个HotelRoomAttrRelController
点评106addHotelComment auditHotelComment batchAuditHotelComment batchDeleteHotelComment …共 10 个HotelCommentController
点评·回复72addHotelCommentReply deleteHotelCommentReply getHotelCommentReply queryHotelCommentReplyList …共 7 个HotelCommentReplyController
点评·日志71addHotelCommentLog deleteHotelCommentLog getHotelCommentLog queryHotelCommentLogList …共 7 个HotelCommentLogController
自动·订单·排除日期60addHotelAutoOrderExcludeDate deleteHotelAutoOrderExcludeDate getHotelAutoOrderExcludeDate queryHotelAutoOrderExcludeDateList …共 6 个HotelAutoOrderExcludeDateController
自动·订单房间·限制60addHotelAutoOrderRoomLimit deleteHotelAutoOrderRoomLimit getHotelAutoOrderRoomLimit queryHotelAutoOrderRoomLimitList …共 6 个HotelAutoOrderRoomLimitController
自动下单规则74addHotelAutoOrderRule deleteHotelAutoOrderRule getHotelAutoOrderRule getHotelAutoOrderRuleLogs …共 7 个HotelAutoOrderRuleController
自动下单规则·日志60addHotelAutoOrderRuleLog deleteHotelAutoOrderRuleLog getHotelAutoOrderRuleLog queryHotelAutoOrderRuleLogList …共 6 个HotelAutoOrderRuleLogController
订单117addHotelOrder cancelHotelOrder checkInHotelOrder checkOutHotelOrder …共 11 个HotelOrderController
订单·日志71addHotelOrderLog deleteHotelOrderLog getHotelOrderLog getHotelOrderLogs …共 7 个HotelOrderLogController
订单房间60addHotelOrderRoom deleteHotelOrderRoom getHotelOrderRoom queryHotelOrderRoomList …共 6 个HotelOrderRoomController
订单支付61addHotelOrderPayment deleteHotelOrderPayment getHotelOrderPayment queryHotelOrderPaymentList …共 6 个HotelOrderPaymentController
设施60addHotelFacility deleteHotelFacility getHotelFacility queryHotelFacilityList …共 6 个HotelFacilityController
设施·关联60addHotelFacilityRel deleteHotelFacilityRel getHotelFacilityRel queryHotelFacilityRelList …共 6 个HotelFacilityRelController
设施·模板75addHotelFacilityTemplate deleteHotelFacilityTemplate getHotelFacilityTemplate getHotelTemplateDetail …共 7 个HotelFacilityTemplateController
设施·模板·明细60addHotelFacilityTemplateDetail deleteHotelFacilityTemplateDetail getHotelFacilityTemplateDetail queryHotelFacilityTemplateDetailList …共 6 个HotelFacilityTemplateDetailController
酒店·信息99addHotelInfo deleteHotelInfo getHotelIdByMerchantIdAndShopId getHotelInfo …共 9 个HotelInfoController

本域常用状态与类型字典

值与含义直接来自后端枚举类,不是人工整理。

类型含义(源码注释)用到接口取值
StockType库存类型160=无限 1=共享 2=独立
CancelType取消类型161=免费取消 2=不可取消 3=有条件取消
HotelGrade酒店等级,1二星及以下/经济,2三星/舒适,3四星/高档,4五星/豪华,5奢华161=二星及以下/经济 2=三星/舒适 3=四星/高档 4=五星/豪华 5=奢华
HotelTemplateType类型151=酒店设施 2=酒店政策 3=其他 4=房型设施 5=房型政策
WindowType窗户类型131=无窗 2=部分有窗 3=全部有窗
NetworkType网络类型131=免费WiFi 2=收费WiFi 3=无网络
HotelType酒店类型131=酒店 2=民宿 3=公寓 4=青年旅社 5=别墅 6=度假村 7=客栈 8=农家乐 9=汽车旅馆 10=露营地 99=其他
HotelOrderStatus订单状态50=待支付 1=待确认 2=待入住 3=已入住 4=已退房 5=已取消 6=部分退房
HotelOrderActionType操作类型51=创建订单 2=支付订单 3=确认订单 4=取消订单 5=入住 6=退房 7=提前退房
HotelOrderActionSource操作来源51=用户端 2=商户端 3=商铺端 4=平台端 5=系统
HotelOrderPaymentType支付状态(0-待支付,1-支付中,2-支付成功,3-支付失败,4-已退款,5-部分退款,6-退款中,7-退款失败))41=支付 2=全额退款 3=部分退款 4=押金 5=押金退还
FacilityType类型31=酒店设施 2=酒店政策 3=其他
HotelOrderPaymentStatus支付状态(0-未支付,1-部分支付,2-已支付,3-已退款,4-部分退款)20=未支付 1=部分支付 2=已支付 3=已退款 4=部分退款 5=退款中 6=退款失败
HotelChannel订单渠道21=质慧游小程序

读写最多的数据表

数据表被多少接口读写反查
hotel_room_type_plan22全部引用
hotel_order20全部引用
hotel_room_type20全部引用
hotel_info19全部引用
hotel_room_price_calendar16全部引用
hotel_room_attr_rel13全部引用
hotel_room_attr13全部引用
hotel_order_room11全部引用
hotel_member_traveler11全部引用
hotel_comment11全部引用
member10全部引用
hotel_facility_rel9全部引用
看这里需要注意:22 个接口是 @Route(auth=false) 免鉴权(不校验登录态),改动前确认调用方与签名校验。
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据