logan

Appearance

代理等级管理 ​

1. 获取代理等级列表 ​

更新于 2025-12-20：返回数据新增对接码列表、代理数量、商品数量

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

请求方式： POST

请求参数：

参数名类型必填说明
namestring否等级名称（模糊搜索）
statusint否状态：0=禁用，1=启用
remarkstring否备注（模糊搜索）
pageint否页码
limitint否每页数量

响应示例：

json
{
  "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",
        "codes": [
          // 该等级的对接码列表 ~~新增于 2025-12-20~~
          {
            "id": 1,
            "code": "DJM1234567890",
            "name": "金牌对接码",
            "status": 1,
            "create_time": "2025-11-19 16:34:13",
            "update_time": "2025-11-19 16:34:13",
            "use_count": 5 // 使用次数
          }
        ],
        "code_count": 1, // 对接码数量 ~~新增于 2025-12-20~~
        "agent_count": 5, // 代理数量 ~~新增于 2025-12-20~~
        "goods_count": 10 // 商品数量 ~~新增于 2025-12-20~~
      }
    ],
    "total": 2
  }
}

2. 创建代理等级 ​

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

请求方式： POST

请求参数：

参数名类型必填说明
namestring是等级名称
sortint否排序值（默认 0）
remarkstring否备注说明
statusint否状态：0=禁用，1=启用（默认 1）

响应示例：

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

业务规则：

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

3. 编辑代理等级 ​

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

请求方式： POST

请求参数：

参数名类型必填说明
idint是等级 ID
namestring是等级名称
sortint否排序值
remarkstring否备注说明
statusint否状态

响应示例：

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

4. 删除代理等级 ​

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

请求方式： POST

请求参数：

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

响应示例：

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

业务规则：

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

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

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

响应示例：

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

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

6. 获取代理等级下的商品列表 ​

新增于 2025-12-20

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

请求方式： POST

请求参数：

参数名类型必填说明
level_idint否代理等级 ID（不传则查询所有等级）
user_idint否按代理用户 ID 筛选
sourcestring否对接类型：1=等级代理，2=货源大厅代理
pageint否页码
limitint否每页数量

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 100,
        "name": "商品名称",
        "price": "50.00",
        "cost_price": "40.00",
        "status": 1,
        "agent_username": "test1001",
        "relation_source": 1,
        "source_text": "等级代理",
        "parent_goods_name": "上级商品名称",
        "parent_goods_id": 50,
        "stock_quantity": 100
      }
    ],
    "total": 10
  }
}

7. 获取代理等级下的代理列表 ​

新增于 2025-12-20

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

请求方式： POST

请求参数：

参数名类型必填说明
level_idint是代理等级 ID
pageint否页码
limitint否每页数量

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 1001,
        "username": "test1001",
        "avatar": "...",
        "agent_level_id": 7,
        "bind_code_id": 1,
        "create_time": "2025-11-20 10:00:00",
        "goods_count": 5
      }
    ],
    "total": 5
  }
}

8. 获取代理等级下的商品 （自己的商品） ​

新增于 2026-1-14

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

请求方式： POST

请求参数：

参数名类型必填说明
level_idint是代理等级 ID
pageint否页码
limitint否每页数量

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 4,  // 商品id
        "name": "商品1e", // 商品名
        "price": "12.00", // 商品价格
        "stock_quantity": 302, // 商品库存
        "create_at": 1766300728, // 创建时间
        "goods_status": 1, // 商品上架状态
        "is_proxy": 0, // 是否为代理商品 是=1 否=0 （用于移除功能时 调用商品编辑接口的区分 0使用接口：/商户端手册/4.商品管理/2.商品管理.html#_4-编辑商品;   1使用接口 /商户端手册/4.商品管理/4.我代理的商品.html#_3-编辑代理商品 ）
        "agent_price": 17, // 给代理的进货销售价格
        "agent_status": 1, // 该等级下 该商品的 代理状态。允许被当前等级代理=1，否=0
        "cate_name": "xxx" // 分类名 
      }
    ],
    "total": 1
  }
}