Skip to content

1. 我的下级分销

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

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

请求方式: POST

请求参数:

参数名类型必填说明
sourceint来源:1=对接码代理,2=货源大厅代理
statusint状态:0=待审核,1=已通过,-1=已拒绝
keywordstring搜索关键词(用户ID或用户名)新增于 2025-12-20
agent_level_idint代理等级ID筛选 新增于 2025-12-20
tabstring标签页:all=全部,level=等级代理,hall=货源大厅 新增于 2025-12-20
sort_fieldstring排序字段:id/create_time/week_profit/week_order_count(默认id)新增于 2025-12-20
sort_orderstring排序方式:asc/desc(默认desc)新增于 2025-12-20
pageint页码
limitint每页数量

响应示例:

json
{
  "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

请求参数:

参数名类型必填说明
idint代理关系ID
statusint审核状态:1=通过,-1=拒绝

响应示例:

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

业务规则:

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

3. 代理统计信息

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

响应示例:

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_count": 50,
    "bind_code_count": 30,
    "supply_hall_count": 20,
    "pending_count": 5,
    "third_count": 100
  }
}

字段说明:

  • total_count: 直属代理总数(已通过)
  • bind_code_count: 对接码代理数量
  • supply_hall_count: 货源大厅代理数量
  • pending_count: 待审核数量
  • third_count: 三级代理数量