POST/hotel/queryHotelCommentPage管理后台

酒店评价表-分页查询

酒店 / 点评· HotelCommentController#queryHotelCommentPage

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentPage
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文点评模块表生成
维护人 / 最后改动liuxu　2024-12-31　最近提交：点评模块表生成
读写数据表hotel_comment　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.hotel.HotelCommentController#queryHotelCommentPage
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/hotel/HotelCommentController.java:77
判定依据1 个调用点：dscp-html-manage/src/api/hotel/hotel.ts

请求参数

分页字段来自 AbstractPageRequest：pageNo（不是 pageNum）· pageSize · orderBy

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 HotelCommentPageRequest

参数名	参数值	是否必填	参数类型	描述说明
pageNo	…	否	Integer	当前页面
pageSize	…	否	Integer	每页记录数
orderBy	…	否	String	排序语句
merchantId	…	否	Long	所属商户id，关联merchant表id → hotel_comment.merchant_id
shopId	…	否	Long	所属商铺id，关联shop表id → hotel_comment.shop_id
hotelId	…	否	Long	→ hotel_comment.hotel_id
status	…	否	Integer	状态 0-待审核 1-已审核 → hotel_comment.status
roomTypeId	…	否	Long	房型ID → hotel_comment.room_type_id
createdTimeRange	…	否	Date[]	购买日期
rating	…	否	Integer	→ hotel_comment.rating

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 PageInfo<HotelCommentResponse>

参数名	参数值	是否必填	参数类型	描述说明
list	…	否	List<T><HotelCommentResponse>	分页数据集合（元素结构见下一行）
id	…	否	Long	id → hotel_comment.id
hotelId	…	否	Long	酒店ID → hotel_comment.hotel_id
roomTypeId	…	否	Long	房型ID → hotel_comment.room_type_id
roomTypeName	…	否	String
orderId	…	否	String	订单号 → hotel_comment.order_id
stayDate	…	否	Date	入住日期 → hotel_comment.stay_date
memberId	…	否	Long	用户ID → hotel_comment.member_id
memberName	…	否	String	用户名称 → hotel_comment.member_name
rating	…	否	Integer	评分 1-5星 → hotel_comment.rating
content	…	否	String	评价内容 → hotel_comment.content
images	…	否	String	图片，逗号隔开 → hotel_comment.images
tags	…	否	String	评价标签，逗号隔开 → hotel_comment.tags
status	…	否	Integer	状态 0-待审核 1-已审核 → hotel_comment.status
isDeleted	…	否	Boolean	是否删除(0-否,1-是) → hotel_comment.is_deleted
createdBy	…	否	Long	创建人 → hotel_comment.created_by
createdTime	…	否	Date	创建时间 → hotel_comment.created_time
updatedBy	…	否	Long	修改人 → hotel_comment.updated_by
updatedTime	…	否	Date	修改时间 → hotel_comment.updated_time
total	…	否	Long	数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "hotelId": "1",
    "roomTypeId": "1",
    "roomTypeName": "\"string\"",
    "orderId": "\"string\"",
    "stayDate": "\"2026-01-01 00:00:00\"",
    "memberId": "1",
    "memberName": "\"string\"",
    "rating": "1",
    "content": "\"string\"",
    "images": "\"string\""
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：hotel_comment　反查全部引用接口 →

HotelCommentController#queryHotelCommentPage
HotelCommentService#queryPage（HotelCommentServiceImpl）
HotelCommentMapper#queryPage
BeanUtils.map → HotelCommentQuery
BeanUtils.mapPage → HotelCommentResponse

其它依赖：HotelRoomTypeCache.get

逻辑摘要：分页查询（hotelCommentService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

源码内联注释（旧站解析结果）

设置时间范围
设置排序
查询评价列表
填充房型名称

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/hotel/hotel.ts:174　管理后台 · request