POST
/hotel/addHotelInfo管理后台酒店信息表-新增
酒店 / 酒店·信息
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/hotel/addHotelInfo - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台（1 个前端）
- 需求上下文
- 维护人 / 最后改动liuxu 2024-12-02
- 读写数据表
shop、hotel_info反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.hotel.HotelInfoController#addHotelInfo - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/hotel/HotelInfoController.java:125 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无（渠道统一鉴权头见《认证方式》） | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| merchantId | … | 是 | Long | 商户ID → hotel_info.merchant_id |
| shopId | … | 否 | Long | 商铺ID → hotel_info.shop_id |
| name | … | 是 | String | 酒店名称 → hotel_info.name |
| grade | … | 是 | HotelGrade | 酒店等级 → hotel_info.grade 1＝二星及以下/经济 2＝三星/舒适 3＝四星/高档 4＝五星/豪华 5＝奢华 |
| type | … | 否 | HotelType | → hotel_info.type 1＝酒店 2＝民宿 3＝公寓 4＝青年旅社 5＝别墅 6＝度假村 7＝客栈 8＝农家乐 9＝汽车旅馆 10＝露营地 99＝其他 |
| openingYear | … | 否 | Integer | 开业年份 → hotel_info.opening_year |
| roomCount | … | 否 | Integer | 房间数量 → hotel_info.room_count |
| phone | … | 否 | String | 联系电话 → hotel_info.phone |
| coverImage | … | 否 | String | 封面图片 → hotel_info.cover_image |
| address | … | 否 | String | 地址 → hotel_info.address |
| landmark | … | 否 | String | 地标 → hotel_info.landmark |
| provinceId | … | 否 | Long | 省id → hotel_info.province_id |
| cityId | … | 否 | Long | 市id → hotel_info.city_id |
| districtId | … | 否 | Long | 区县id → hotel_info.district_id |
| longitude | … | 否 | BigDecimal | 经度 → hotel_info.longitude |
| latitude | … | 否 | BigDecimal | 纬度 → hotel_info.latitude |
| highlights | … | 否 | String | 亮点介绍 → hotel_info.highlights |
| tags | … | 否 | String | 酒店标签 → hotel_info.tags |
| locationTags | … | 否 | String | 位置标签 → hotel_info.location_tags |
| images | … | 否 | String | 酒店图片，多个用逗号分隔 → hotel_info.images |
| status | … | 否 | Integer | 状态(0正常 1停用) → hotel_info.status |
| facilities | … | 否 | List<FacilityTree> | 设施列表 |
| name | … | 是 | String | 名称 → hotel_info.name |
| type | … | 是 | String | 类型 → hotel_info.type 1＝酒店 2＝民宿 3＝公寓 4＝青年旅社 5＝别墅 6＝度假村 7＝客栈 8＝农家乐 |
| level | … | 是 | Integer | 层级 → shop.level |
| sort | … | 是 | Integer | 排序 |
| children | … | 否 | List<FacilityTree> | 子节点 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| void —— 不返回业务数据（外层包装见全局公共参数） | ||||
响应示例
成功响应示例
{"errcode":0,"errmsg":""}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：shop、hotel_info 反查全部引用接口 →
- HotelInfoController#addHotelInfo
- ShopService#addShop（ShopServiceImpl）
- BeanUtils.map → Shop ⇒ 表 shop
- BeanUtils.map → HotelInfo ⇒ 表 hotel_info
其它依赖：ChaosTransactionTemplate.execute
逻辑摘要：新增（shopService.addShop）；新增（hotelInfoService.add）；入参与返回值经 BeanUtils 做对象/分页映射
操作日志：hotel / 新增酒店
源码内联注释（旧站解析结果）
- 商铺信息
- 1. 保存酒店基本信息
- 2. 递归保存设施信息
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
dscp-html-manage/src/api/hotel/hotel.ts:28管理后台 · request