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": "保存成功"
}说明:
- 店铺名称与公告提交时会进行内容校验,返回码与提示以接口实际为准
- 未填写的可选字段按服务端默认处理