地区 region

模块 region：共 7 个接口 —— 1 个被前端调用（在用），6 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

RegionController 1/7 在用

POST /region/addRegion 未使用管理后台 #

地区信息-新增 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#addRegion
所属模块	地区 `region`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表region

ControllerRegionController#addRegion

转换BeanUtils.map → Region ⇒ 表 region

ServiceRegionService#add （RegionServiceImpl）

MapperRegionMapper#insert ⇒ 表 region

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/region/addRegion
uat	https://dscp-uat.hn12301.net/manage-api/region/addRegion
pro	https://dscp-uat.hn12301.net/manage-api/region/addRegion	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　RegionAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String	是	必填	`region`.`name`	地名
parentId	Long			`region`.`parent_id`	父Id
shortName	String			`region`.`short_name`	简称
levelType	Integer	是	必填	`region`.`level_type`	级别
cityCode	String			`region`.`city_code`	城市编码
zipCode	String			`region`.`zip_code`	邮政编码
mergerName	String			`region`.`merger_name`	合并名称
lng	BigDecimal			`region`.`lng`	经度
lat	BigDecimal			`region`.`lat`	纬度
pinYin	String			`region`.`pin_yin`	拼音

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　RegionResponse　（object）

字段	类型	表 / 列	说明
id	Long	`region`.`id`	主键
name	String	`region`.`name`	地名
parentId	Long	`region`.`parent_id`	父Id
shortName	String	`region`.`short_name`	简称
levelType	Integer	`region`.`level_type`	级别
cityCode	String	`region`.`city_code`	城市编码
zipCode	String	`region`.`zip_code`	邮政编码
mergerName	String	`region`.`merger_name`	合并名称
lng	BigDecimal	`region`.`lng`	经度
lat	BigDecimal	`region`.`lat`	纬度
pinYin	String	`region`.`pin_yin`	拼音

示例

请求示例（自动生成，仅结构参考）

POST /region/addRegion

{
  "body": {
    "name": "",
    "parentId": 1,
    "shortName": "",
    "levelType": 0,
    "cityCode": "",
    "zipCode": "",
    "mergerName": "",
    "lng": 0,
    "lat": 0,
    "pinYin": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "parentId": 1,
    "shortName": "",
    "levelType": 0,
    "cityCode": "",
    "zipCode": "",
    "mergerName": "",
    "lng": 0,
    "lat": 0,
    "pinYin": ""
  }
}

处理逻辑

操作日志region / 新增地区

逻辑摘要新增（regionService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /region/deleteRegion 未使用管理后台 #

地区信息-删除 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#deleteRegion
所属模块	地区 `region`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表region

ControllerRegionController#deleteRegion

ServiceRegionService#delete （RegionServiceImpl）

MapperRegionMapper#deleteById ⇒ 表 region

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/region/deleteRegion
uat	https://dscp-uat.hn12301.net/manage-api/region/deleteRegion
pro	https://dscp-uat.hn12301.net/manage-api/region/deleteRegion	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`region`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /region/deleteRegion

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志region / 删除地区

逻辑摘要删除（regionService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /region/getRegion 未使用管理后台 #

地区信息-详情 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#getRegion
所属模块	地区 `region`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表region

ControllerRegionController#getRegion

ServiceRegionService#get （RegionServiceImpl）

MapperRegionMapper#selectById ⇒ 表 region

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/region/getRegion
uat	https://dscp-uat.hn12301.net/manage-api/region/getRegion
pro	https://dscp-uat.hn12301.net/manage-api/region/getRegion	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`region`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　RegionResponse　（object）

字段	类型	表 / 列	说明
id	Long	`region`.`id`	主键
name	String	`region`.`name`	地名
parentId	Long	`region`.`parent_id`	父Id
shortName	String	`region`.`short_name`	简称
levelType	Integer	`region`.`level_type`	级别
cityCode	String	`region`.`city_code`	城市编码
zipCode	String	`region`.`zip_code`	邮政编码
mergerName	String	`region`.`merger_name`	合并名称
lng	BigDecimal	`region`.`lng`	经度
lat	BigDecimal	`region`.`lat`	纬度
pinYin	String	`region`.`pin_yin`	拼音

示例

请求示例（自动生成，仅结构参考）

POST /region/getRegion

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "parentId": 1,
    "shortName": "",
    "levelType": 0,
    "cityCode": "",
    "zipCode": "",
    "mergerName": "",
    "lng": 0,
    "lat": 0,
    "pinYin": ""
  }
}

处理逻辑

逻辑摘要查询详情（regionService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /region/queryRegionList 在用开放/回调 #

地区信息-列表查询 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#queryRegionList
所属模块	地区 `region`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerRegionController#queryRegionList

转换BeanUtils.map → RegionQuery

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

RegionListCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/region/queryRegionList
uat	https://dscp-uat.hn12301.net/open-api/region/queryRegionList
pro	https://dscp-uat.hn12301.net/open-api/region/queryRegionList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　RegionListRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String	否	可选(@MvcOptional)	—	地名
parentId	Long	否	可选(@MvcOptional)	—	父Id
shortName	String	否	可选(@MvcOptional)	—	简称
levelType	Integer	否	可选(@MvcOptional)	—	级别
cityCode	String	否	可选(@MvcOptional)	—	城市编码
zipCode	String	否	可选(@MvcOptional)	—	邮政编码
mergerName	String	否	可选(@MvcOptional)	—	合并名称
lng	BigDecimal	否	可选(@MvcOptional)	—	经度
lat	BigDecimal	否	可选(@MvcOptional)	—	纬度
pinYin	String	否	可选(@MvcOptional)	—	拼音
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<RegionResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	—	主键
name	String	—	地名
parentId	Long	—	父Id
shortName	String	—	简称
levelType	Integer	—	级别
cityCode	String	—	城市编码
zipCode	String	—	邮政编码
mergerName	String	—	合并名称
lng	BigDecimal	—	经度
lat	BigDecimal	—	纬度
pinYin	String	—	拼音

示例

请求示例（自动生成，仅结构参考）

POST /region/queryRegionList

{
  "body": {
    "name": "",
    "parentId": 1,
    "shortName": "",
    "levelType": 0,
    "cityCode": "",
    "zipCode": "",
    "mergerName": "",
    "lng": 0,
    "lat": 0,
    "pinYin": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "parentId": 1,
      "shortName": "",
      "levelType": 0,
      "cityCode": "",
      "zipCode": "",
      "mergerName": "",
      "lng": 0,
      "lat": 0,
      "pinYin": ""
    }
  ]
}

处理逻辑

逻辑摘要见下方调用链；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryRegionList exact

POST /region/queryRegionPage 未使用管理后台 #

地区信息-分页查询 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#queryRegionPage
所属模块	地区 `region`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表region

ControllerRegionController#queryRegionPage

转换BeanUtils.map → RegionQuery

ServiceRegionService#queryPage （RegionServiceImpl）

MapperRegionMapper#selectPage ⇒ 表 region

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/region/queryRegionPage
uat	https://dscp-uat.hn12301.net/manage-api/region/queryRegionPage
pro	https://dscp-uat.hn12301.net/manage-api/region/queryRegionPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　RegionPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
name	String	否	可选(@MvcOptional)	`region`.`name`	地名
parentId	Long	否	可选(@MvcOptional)	`region`.`parent_id`	父Id
shortName	String	否	可选(@MvcOptional)	`region`.`short_name`	简称
levelType	Integer	否	可选(@MvcOptional)	`region`.`level_type`	级别
cityCode	String	否	可选(@MvcOptional)	`region`.`city_code`	城市编码
zipCode	String	否	可选(@MvcOptional)	`region`.`zip_code`	邮政编码
mergerName	String	否	可选(@MvcOptional)	`region`.`merger_name`	合并名称
lng	BigDecimal	否	可选(@MvcOptional)	`region`.`lng`	经度
lat	BigDecimal	否	可选(@MvcOptional)	`region`.`lat`	纬度
pinYin	String	否	可选(@MvcOptional)	`region`.`pin_yin`	拼音
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<RegionResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`region`.`id`	主键
name	String	`region`.`name`	地名
parentId	Long	`region`.`parent_id`	父Id
shortName	String	`region`.`short_name`	简称
levelType	Integer	`region`.`level_type`	级别
cityCode	String	`region`.`city_code`	城市编码
zipCode	String	`region`.`zip_code`	邮政编码
mergerName	String	`region`.`merger_name`	合并名称
lng	BigDecimal	`region`.`lng`	经度
lat	BigDecimal	`region`.`lat`	纬度
pinYin	String	`region`.`pin_yin`	拼音

示例

请求示例（自动生成，仅结构参考）

POST /region/queryRegionPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "name": "",
    "parentId": 1,
    "shortName": "",
    "levelType": 0,
    "cityCode": "",
    "zipCode": "",
    "mergerName": "",
    "lng": 0,
    "lat": 0,
    "pinYin": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "name": "",
        "parentId": 1,
        "shortName": "",
        "levelType": 0,
        "cityCode": "",
        "zipCode": "",
        "mergerName": "",
        "lng": 0,
        "lat": 0,
        "pinYin": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /region/queryRegionTree 未使用管理后台 #

地区信息-树查询 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#queryRegionTree
所属模块	地区 `region`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerRegionController#queryRegionTree

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

RegionTreeCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/region/queryRegionTree
uat	https://dscp-uat.hn12301.net/manage-api/region/queryRegionTree
pro	https://dscp-uat.hn12301.net/manage-api/region/queryRegionTree	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<RegionTreeResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	—	主键
name	String	—	地名
parentId	Long	—	父Id
shortName	String	—	简称
levelType	Integer	—	级别
cityCode	String	—	城市编码
zipCode	String	—	邮政编码
mergerName	String	—	合并名称
lng	BigDecimal	—	经度
lat	BigDecimal	—	纬度
pinYin	String	—	拼音
children	List<RegionTreeResponse>	—	子级
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /region/queryRegionTree

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "parentId": 1,
      "shortName": "",
      "levelType": 0,
      "cityCode": "",
      "zipCode": "",
      "mergerName": "",
      "lng": 0,
      "lat": 0,
      "pinYin": "",
      "children": [
        {}
      ]
    }
  ]
}

处理逻辑

逻辑摘要见下方调用链

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /region/updateRegion 未使用管理后台 #

地区信息-更新 · RegionController

基本信息

控制器	com.jxxx.dscp.api.controller.region.RegionController#updateRegion
所属模块	地区 `region`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表region

ControllerRegionController#updateRegion

转换BeanUtils.map → Region ⇒ 表 region

ServiceRegionService#update （RegionServiceImpl）

MapperRegionMapper#updateById ⇒ 表 region

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/region/updateRegion
uat	https://dscp-uat.hn12301.net/manage-api/region/updateRegion
pro	https://dscp-uat.hn12301.net/manage-api/region/updateRegion	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　RegionUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`region`.`id`	主键
name	String	是	必填	`region`.`name`	地名
parentId	Long			`region`.`parent_id`	父Id
shortName	String			`region`.`short_name`	简称
levelType	Integer	是	必填	`region`.`level_type`	级别
cityCode	String			`region`.`city_code`	城市编码
zipCode	String			`region`.`zip_code`	邮政编码
mergerName	String			`region`.`merger_name`	合并名称
lng	BigDecimal			`region`.`lng`	经度
lat	BigDecimal			`region`.`lat`	纬度
pinYin	String			`region`.`pin_yin`	拼音

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /region/updateRegion

{
  "body": {
    "id": 1,
    "name": "",
    "parentId": 1,
    "shortName": "",
    "levelType": 0,
    "cityCode": "",
    "zipCode": "",
    "mergerName": "",
    "lng": 0,
    "lat": 0,
    "pinYin": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志region / 更新地区

逻辑摘要更新（regionService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）