POST/merchant/getMerchant管理后台

Merchant-详情

商户·店铺·基础数据 / 商户· MerchantController#getMerchant

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/merchant/getMerchant
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文feat:新增商户&地区管理
维护人 / 最后改动AsiQue　2023-11-29　最近提交：feat:新增商户&地区管理
读写数据表merchant　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.merchant.MerchantController#getMerchant
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/merchant/MerchantController.java:152
判定依据1 个调用点：dscp-html-manage/src/api/merchant/index.ts

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 IdRequest

参数名	参数值	是否必填	参数类型	描述说明
id	…	是	Long	id → merchant.id

认证方式

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

响应参数

data 类型 MerchantResponse

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	商户id，主键 → merchant.id
merchantType	…	否	MerchantType	商户类型 → merchant.merchant_type 1＝供应商 2＝分销商 3＝发卡商 4＝其他 5＝酒店 6＝第三方
fullName	…	否	String	商户名称 → merchant.full_name
shortName	…	否	String	商户简称 → merchant.short_name
uscc	…	否	String	社会信用统一代码 → merchant.uscc
logo	…	否	String	商户LOGO图片url地址 → merchant.logo
provinceId	…	否	Long	省id → merchant.province_id
cityId	…	否	Long	市id → merchant.city_id
districtId	…	否	Long	区县id → merchant.district_id
address	…	否	String	所在地区
license	…	否	String	营业执照图片url地址 → merchant.license
introduction	…	否	String	商户简介 → merchant.introduction
linkman	…	否	String	商户联系人 → merchant.linkman
linkphone	…	否	String	商户联系人手机 → merchant.linkphone
manager	…	否	String	商户客户经理 → merchant.manager
managerName	…	否	String	客户经理名称
corporate	…	否	String	法人代表人 → merchant.corporate
treasurer	…	否	String	财务负责人 → merchant.treasurer
treasurerPhone	…	否	String	财务负责人电话 → merchant.treasurer_phone
setupDay	…	否	Date	成立日期 → merchant.setup_day
businessType	…	否	BusinessType	企业类型，1.个体工商户，2.合伙企业，3.有限公司，4.个人独资企业，5.股份有限公司，6.集团公司，7.国有企业，8.外资企业，9.分公司 → merchant.business_type 1＝内资企业 2＝国有企业 3＝集体企业 4＝股份合作 5＝联营企业 6＝有限责任公司 7＝股份有限公司 8＝其他企业 9＝港澳台商投资企业 10＝外商投资企业
industryId	…	否	Long	所属行业 → merchant.industry_id
industryName	…	否	String	所属行业名称
businessScale	…	否	ScaleType	企业规模，1大型、2中型、3小型、4微型 → merchant.business_scale 1＝大型 2＝中型 3＝小型 4＝微型
investMoney	…	否	Integer	注册资本(万元) → merchant.invest_money
financeType	…	否	FinanceType	融资轮次，1初创、2PerA、3A轮、4A+轮、5B轮、6B+轮、7C轮、8C+轮、9D轮、10D+轮、11E轮、12E+轮、13PerIPO、14已上市 → merchant.finance_type 1＝初创 2＝PerA 3＝A轮 4＝A+轮 5＝B轮 6＝B+轮 7＝C轮 8＝C+轮 9＝D轮 10＝D+轮 11＝E轮 12＝E+轮 13＝PerIPO 14＝已上市
businessScopes	…	否	String	营业范围 → merchant.business_scopes
remark	…	否	String	备注 → merchant.remark
postalAddress	…	否	String	通讯地址 → merchant.postal_address
registeredAddress	…	否	String	注册地址 → merchant.registered_address
businessAddress	…	否	String	营业地址 → merchant.business_address
merchantStatus	…	否	MerchantStatus	商户状态，1.正常2.停业 → merchant.merchant_status 1＝正常 2＝停业

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "merchantType": "1",
    "fullName": "\"string\"",
    "shortName": "\"string\"",
    "uscc": "\"string\"",
    "logo": "\"string\"",
    "provinceId": "1",
    "cityId": "1",
    "districtId": "1",
    "address": "\"string\"",
    "license": "\"string\"",
    "introduction": "\"string\""
  }
}

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

附录 · 实现细节

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

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

MerchantController#getMerchant
MerchantService#mustGet（MerchantServiceImpl）
MerchantMapper#mustGet

其它依赖：MerchantService.mustGet

逻辑摘要：调用 mustGet（merchantService.mustGet）

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

调用点证据

dscp-html-manage/src/api/merchant/index.ts:16　管理后台 · request