Skip to content

1 获取店铺设置

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

响应示例:

json
{
  "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:是
      "shop_contact": {
        // 联系方式
        "site_link": "https://example.com", // 官网地址
        "qq": "123456789", // QQ号
        "wechat": "wxid_123", // 微信号
        "mobile": "13800138000" // 手机号
      },
      "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

请求示例(POST JSON):

json
{
  "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
  "shop_contact": {
    // 联系方式
    "site_link": "https://example.com", // 官网地址
    "qq": "123456789", // QQ号
    "wechat": "wxid_123", // 微信号
    "mobile": "13800138000" // 手机号
  },
  "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
}

响应示例:

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

说明:

  • 店铺名称与公告提交时会进行内容校验,返回码与提示以接口实际为准
  • 未填写的可选字段按服务端默认处理