1 获取店铺设置

接口地址：/merchantapi/shop/config/index

变更记录：2026-1-30 移除 show_contact ；shop_contact改为文本

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "shop_contact_tip": "联系方式必须开启，可选择'任意一项'", // 联系方式提示信息（可能为空或包含提示语）
    "shop": {
      "id": 1, // 店铺ID
      "user_id": 100, // 用户ID
      "shop_name": "我的店铺", // 店铺名称（建议2-10位）
      "shop_notice": "<p>欢迎光临</p>", // 店铺公告（支持富文本HTML）
      "shop_notice_show": 1, // 公告开关 0:关闭 1:开启
      "shop_close": 0, // 店铺状态 0:营业 1:休息
      "shop_close_notice": "", // 休息状态提示
      "show_contact": 1, // 是否显示联系方式 0:否 1:是  2026-1-30移除
      "shop_contact": "", // 联系方式  2026-1-30改为文本
      "stock_display": 1, // 库存展示 0:不显示 1:显示数量 2:范围文字
      "shop_logo": "https://example.com/logo.png", // 店铺Logo
      "show_merchant_time": 1, // 是否显示开店时间 0:否 1:是
      "show_score": 1 // 是否显示信誉分 0:否 1:是
    }
  }
}

说明：

• 库存展示为枚举（0/1/2），范围文字规则：充足(>100)；很多(30-100)；一般(10-30)；少量(<10)
• shop_contact_tip 为系统动态提示，用于引导填写联系方式

---

2 保存店铺设置

接口地址：/merchantapi/shop/config/saveConfig

请求参数：

参数名	类型	必填	说明
shop_name	string	否	店铺名称（建议2-10位，支持中文/字母/数字/下划线/表情）
shop_notice	string	否	店铺公告（支持富文本HTML）
shop_notice_show	int	否	公告开关：0=关闭，1=开启
shop_close	int	否	店铺状态：0=营业，1=休息
shop_close_notice	string	否	休息状态提示
shop_contact	string	否	联系方式文本
stock_display	int	否	库存展示：0=不显示，1=显示数量，2=范围文字
shop_logo	string	否	店铺Logo URL
show_merchant_time	int	否	是否显示开店时间：0=否，1=是
show_score	int	否	是否显示信誉分：0=否，1=是
shop_intro	string	否	店铺简介

请求示例（POST JSON）：

{
  "shop_name": "我的店铺", // 店铺名称（建议2-10位，支持中文/字母/数字/下划线/表情）
  "shop_notice": "<p>欢迎光临我的店铺</p>", // 店铺公告（支持富文本HTML）
  "shop_notice_show": 1, // 公告开关 0/1
  "shop_close": 0, // 店铺状态 0:营业 1:休息
  "shop_close_notice": "", // 休息状态提示
  "shop_contact": "QQ:123456789 / Telegram:@demo", // 联系方式文本
  "stock_display": 1, // 库存展示 0:不显示 1:显示数量 2:范围文字
  "shop_logo": "https://example.com/logo.png", // 店铺Logo
  "show_merchant_time": 1, // 是否显示开店时间 0/1
  "show_score": 1, // 是否显示信誉分 0/1
  "shop_intro": "店铺简介"
}

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

说明：

• 店铺名称与公告提交时会进行内容校验，返回码与提示以接口实际为准
• 未填写的可选字段按服务端默认处理
• 当前后端不再读取 show_contact，shop_contact 为字符串文本，不再是结构化对象

---

3 获取店铺扩展配置

接口地址：/merchantapi/shop/shopextension/getConfigs

请求参数：

参数名	类型	必填	说明
type	string	否	扩展类型；不传返回全部扩展配置

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "enabled": 1
  }
}

说明：

• 传 type 时返回该扩展配置，并额外包含 enabled
• 不传 type 时返回以扩展类型为 key 的配置对象；没有配置时返回空对象

---

4 保存店铺扩展配置

接口地址：/merchantapi/shop/shopextension/saveConfigs

请求参数：

参数名	类型	必填	说明
configs	object	是	扩展配置集合，key 为扩展类型，value 为配置对象

请求示例：

{
  "configs": {
    "demo": {
      "enabled": true,
      "title": "扩展示例"
    }
  }
}

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

说明：

• 保存时每个扩展配置里的 enabled 会单独保存为启用状态，其余字段保存到配置数据中