1. 我代理的商品列表

接口地址： /merchantapi/distribution/goods/myAgentGoods

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	否	商品 ID
cate_id	int	否	分类 ID
name	string	否	商品名称
status	int	否	状态
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 100,
        "name": "QQ币100元",
        "cate_name": "游戏点卡",
        "price": "95.00",
        "stock": 1000, // 该商品的库存数量
        "cards_sold_counts": 500, // 通过该商品售出的卡密数量
        "status": 1 // 状态 1:正常 2:下架
        // ...其余信息同我的商品列表字段含义信息
      }
    ],
    "total": 10
  }
}

---

2. 获取代理商品详情

接口地址： /merchantapi/distribution/goods/detail

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	代理商品 ID

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "id": 100,
    "name": "QQ币100元",
    "price": "95.00",
    "cost_price": "90.00",
    "can_proxy": 0,
    "is_proxy": 1,
    "parent_user_id": 50,
    "source_user_id": 10
  }
}

说明：

• cost_price 为上级给的代理价格
• can_proxy 根据上级设置和代理层级自动判断

---

3. 编辑代理商品

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

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	代理商品 ID
cate_id	int	是	分类 ID
name	string	是	商品名称
price	float	是	售价
sort	int	否	排序
wholesale_discount	int	否	是否开启批发优惠
wholesale_discount_list	array	否	批发价格列表
inventory_notify	int	否	库存预警值
sold_notify	int	否	售出通知
content	string	否	商品说明
remark	string	否	使用说明
proxy_sync_content	int	否	是否同步上级内容
can_proxy	int	否	是否允许代理（受上级限制）
hall_price	float	否	货源大厅价格
agent_prices	array	否	代理等级价格数组

响应示例：

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

业务规则：

• 售价不能低于成本价
• 批发价不能低于成本价
• 代理价格不能低于成本价
• 如果是二级或更高级别代理，强制关闭代理权限
• 修改货源大厅价格会下架所有下级代理商品

4. 商品上下架

同 ./2.商品管理.md 商品上下架

5. 删除商品

同 ./2.商品管理.md 删除商品