POST
/shop/addShop管理后台Shop-新增
商户·店铺·基础数据 / 店铺
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/shop/addShop - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台（1 个前端）
- 需求上下文
- 维护人 / 最后改动AsiQue 2023-11-24
- 读写数据表
shop反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.shop.ShopController#addShop - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/shop/ShopController.java:249 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无（渠道统一鉴权头见《认证方式》） | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| merchantId | … | 是 | Long | 所属商户id，关联merchant表id → shop.merchant_id |
| name | … | 是 | String | 商铺名称 → shop.name |
| logo | … | 否 | String | 商铺LOGO图片url地址 → shop.logo |
| typeId | … | 否 | Long | 商铺大类 → shop.type_id |
| subTypeId | … | 否 | Long | 商铺小类ID → shop.sub_type_id |
| status | … | 否 | ShopStatus | 商铺状态 → shop.status 1＝正常运营 2＝审核中 3＝暂停运营 4＝已关店 |
| provinceId | … | 否 | String | 省id → shop.province_id |
| cityId | … | 否 | String | 市id → shop.city_id |
| districtId | … | 否 | String | 区县id → shop.district_id |
| address | … | 否 | String | 商铺地址 → shop.address |
| mobile | … | 否 | String | 客服电话 → shop.mobile |
| linkman | … | 否 | String | 商户联系人 → shop.linkman |
| linkphone | … | 否 | String | 商户联系人手机 → shop.linkphone |
| manager | … | 否 | String | 专属客户经理 → shop.manager |
| level | … | 否 | String | 等级 → shop.level |
| lng | … | 否 | String | 经度 → shop.lng |
| lat | … | 否 | String | 纬度 → shop.lat |
| introduction | … | 否 | String | 简介 → shop.introduction |
| businessTime | … | 否 | String | 营业时间 → shop.business_time |
| tags | … | 否 | String | 商铺标签 → shop.tags |
| mainPic | … | 否 | String | 景区主图url地址 → shop.main_pic |
| propagatePic | … | 否 | String | 宣传图片url地址 → shop.propagate_pic |
| video | … | 否 | String | 景区视频url地址 → shop.video |
| poster | … | 否 | String | 分享海报url地址 → shop.poster |
| propagateContent | … | 否 | String | 宣传语 → shop.propagate_content |
| description | … | 否 | String | 图文详情 → shop.description |
| ticketInfo | … | 否 | String | 门票信息 → shop.ticket_info |
| trafficInfo | … | 否 | String | 交通信息 → shop.traffic_info |
| tips | … | 否 | String | 温馨提示 → shop.tips |
| thirdId | … | 否 | String | → shop.third_id |
| thirdName | … | 否 | String | → shop.third_name |
| relationList | … | 否 | List<ShopRelationAddRequest> | |
| thirdName | … | 否 | String | 名称 → shop.third_name |
| thirdId | … | 否 | String | → shop.third_id |
| channelType | … | 否 | ChannelType | |
| remark | … | 否 | String | xuchao: 第三方备注 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| void —— 不返回业务数据（外层包装见全局公共参数） | ||||
响应示例
成功响应示例
{"errcode":0,"errmsg":""}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：shop 反查全部引用接口 →
- ShopController#addShop
- ShopService#addShop（ShopServiceImpl）
- BeanUtils.map → Shop ⇒ 表 shop
其它依赖：ChaosTransactionTemplate.execute
逻辑摘要：新增（shopService.addShop）；调用 execute（newTransactionTemplate.execute）；新增（shopService.add）；入参与返回值经 BeanUtils 做对象/分页映射
操作日志：shop / 新增商铺
源码内联注释（旧站解析结果）
- 新增商户
- 创建商铺顶级部门
- 创建商户默认用户
- 新增关联
- 回滚事务
- 处理异常
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
dscp-html-manage/src/api/shop/index.ts:12管理后台 · request