1. 获取黑名单列表

接口地址： /merchantapi/shop/black/list

请求方式： POST

请求参数：

参数名	类型	必填	说明
date_range	array	否	日期范围
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 2,
        "buyer_user_id": 1, // 买家用户ID
        "create_at": "2025-11-23 00:03:46", // 创建时间
        "status": 1, // 状态：0=禁用，1=启用
        "remark": "禁用", // 备注
        "shop_id": 2 // 当前店铺ID
      }
    ],
    "total": 10
  }
}

---

2. 获取黑名单详情

接口地址： /merchantapi/shop/black/detail

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	黑名单 ID

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "id": 2,
    "buyer_user_id": 1,
    "create_at": "2025-11-23 00:03:46",
    "status": 1,
    "remark": "禁用",
    "shop_id": 2
  }
}

---

3. 添加黑名单

接口地址： /merchantapi/shop/black/add

请求方式： POST

请求参数：

参数名	类型	必填	说明
buyer_user_id	int	是	买家用户 ID
id	int	否	黑名单 ID（新增时为 0）
remark	string	否	备注
status	int	否	状态：0=禁用，1=启用（默认 1）

响应示例：

{
  "code": 1,
  "msg": "添加成功"
}

---

4. 编辑黑名单

接口地址： /merchantapi/shop/black/edit

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	黑名单 ID
buyer_user_id	int	是	买家用户 ID
remark	string	否	备注
status	int	否	状态：0=禁用，1=启用

响应示例：

{
  "code": 1,
  "msg": "编辑成功"
}

---

5. 删除黑名单

接口地址： /merchantapi/shop/black/del

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	黑名单 ID

响应示例：

{
  "code": 1,
  "msg": "删除成功"
}

---

6. 清空黑名单

接口地址： /merchantapi/shop/black/clear

响应示例：

{
  "code": 1,
  "msg": "清空成功"
}