1. 我的下级分销

更新于 2025-12-20：新增多种筛选条件、排序功能、统计数据

接口地址： /merchantapi/distribution/agentrelation/myAgentList

请求方式： POST

请求参数：

参数名	类型	必填	说明
source	int	否	来源：1=对接码代理，2=货源大厅代理
status	int	否	状态：0=待审核，1=已通过，-1=已拒绝
keyword	string	否	搜索关键词（当前实现仅搜索下级用户ID）新增于 2025-12-20
agent_level_id	int	否	代理等级ID筛选 新增于 2025-12-20
tab	string	否	标签页：all=全部，level=等级代理，hall=货源大厅 新增于 2025-12-20
sort_field	string	否	排序字段：id/create_time/week_profit/week_order_count（默认id）新增于 2025-12-20
sort_order	string	否	排序方式：asc/desc（默认desc）新增于 2025-12-20
page	int	否	页码
limit	int	否	每页数量

特殊规则：

• tab=level 会筛选 source=1，tab=hall 会筛选 source=2；如果同时传 source 且与 tab 冲突，会叠加条件导致结果为空。
• sort_field=id/create_time 使用数据库排序；week_profit/week_order_count 是分页后在 PHP 层对当前页排序，不是全量数据排序。
• source、status、agent_level_id 为空字符串时不参与筛选。
• week_supply_amount 仅汇总近 7 日支付成功（status=1）的订单，已关闭/取消（status=2）和已退款（status=3）订单不计入供货额。

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 200,
        "parent_id": 100,
        "top_user_id": 100,
        "agent_username": "代理商A",
        "agent_shop_name": "代理商A的店铺",
        "level_name": "金牌代理",
        "source": 1,
        "status": 1,
        "goods_count": 10,
        "is_blacklist": false, // 是否在黑名单中 ~~新增于 2025-12-20~~
        "blacklist_id": 0, // 黑名单记录ID ~~新增于 2025-12-20~~
        "week_supply_amount": "1000.00", // 近7日供货额 ~~新增于 2025-12-20~~
        "week_order_count": 50, // 近7日订单量 ~~新增于 2025-12-20~~
        "week_profit": "200.00", // 近7日收益 ~~新增于 2025-12-20~~
        "today_order_count": 5, // 今日订单 ~~新增于 2025-12-20~~
        "create_time": 1699999999
      }
    ],
    "total": 20
  }
}

字段说明：

• 删除于 2025-12-20 agent_type: 代理类型：1=直属代理，2=三级代理
• 删除于 2025-12-20 agent_text: 代理类型文本
• goods_count: 对接商品数量
• source: 来源：1=对接码代理，2=货源大厅代理
• 新增于 2025-12-20 is_blacklist: 是否在黑名单中
• 新增于 2025-12-20 week_supply_amount: 近7日供货额（代理从我这里拿货且支付成功的订单金额，不含已关闭/取消及已退款订单）
• 新增于 2025-12-20 week_order_count: 近7日订单量
• 新增于 2025-12-20 week_profit: 近7日收益（我从该代理订单获得的收益）
• 新增于 2025-12-20 today_order_count: 今日订单数

2. 审核代理申请

接口地址： /merchantapi/distribution/agentrelation/auditagent

请求方式： POST

请求参数：

参数名	类型	必填	说明
id	int	是	代理关系ID
status	int	是	审核状态：1=通过，-1=拒绝

响应示例：

{
  "code": 1,
  "msg": "审核通过成功"
}

业务规则：

• 只能审核直属代理的申请
• 审核通过后发送站内消息通知
• 审核拒绝会下架该代理已对接的所有商品

---

3. 代理统计信息

接口地址： /merchantapi/distribution/agentrelation/statistics

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_count": 50,
    "level_count": 30,
    "hall_count": 20,
    "week_order_count": 100
  }
}

字段说明：

• total_count: 直属代理总数（所有状态）
• level_count: 等级代理/对接码代理数量
• hall_count: 货源大厅代理数量
• week_order_count: 近7日订单数