代理等级管理

1. 获取代理等级列表

接口地址： /merchantapi/distribution/agentlevel/list

请求方式： POST

请求参数：

参数名	类型	必填	说明
name	string	否	等级名称（模糊搜索）
status	int	否	状态：0=禁用，1=启用
remark	string	否	备注（模糊搜索）
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 7,
        "user_id": 1000,
        "name": "金牌",
        "sort": 0,
        "remark": "",
        "status": 1,
        "create_time": "2025-11-09 15:49:59",
        "update_time": "2025-11-09 15:51:04"
      }
    ],
    "total": 2
  }
}

---

2. 创建代理等级

接口地址： /merchantapi/distribution/agentlevel/create

请求方式： POST

请求参数：

参数名	类型	必填	说明
name	string	是	等级名称
sort	int	否	排序值（默认 0）
remark	string	否	备注说明
status	int	否	状态：0=禁用，1=启用（默认 1）

响应示例：

{
  "code": 1,
  "msg": "创建成功"
}

业务规则：

• 最多只能创建 5 个代理等级，含隐藏等级
• 等级名称不能为空

---

3. 编辑代理等级

接口地址： /merchantapi/distribution/agentlevel/edit

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	等级 ID
name	string	是	等级名称
sort	int	否	排序值
remark	string	否	备注说明
status	int	否	状态

响应示例：

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

---

4. 删除代理等级

接口地址： /merchantapi/distribution/agentlevel/delete

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	等级 ID

响应示例：

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

业务规则：

• 删除等级时会自动删除该等级的所有对接码
• 会下架所有使用该等级的代理商品
• 会删除该等级的所有商品代理价格设置
• 会向代理商发送通知消息

---

5. 获取可用代理等级列表

接口地址： /merchantapi/distribution/agentlevel/enabledlist

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": [
    {
      "id": 1,
      "name": "金牌代理",
      "sort": 100,
      "status": 1
    }
  ]
}

说明： 只返回状态为启用的代理等级

---