1 搜索对接码

接口地址： /merchantapi/distribution/apply/searchbindcode

请求方式： POST

请求参数：

参数名	类型	必填	说明
code	string	是	对接码

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "merchant": {
      "merchant_username": "商户A",
      "shop_name": "商户A的店铺",
      "parent_user_id": 100
    },
    "bind_code_info": {
      "code": "DJM1234567890",
      "agent_level_id": 1,
      "level_info": {
        "level_id": 1,
        "level_name": "金牌代理"
      }
    },
    "relation_status": "none", // 代理关系状态：none=无关系，pending=待审核，approved=已通过，rejected=已拒绝，level_diff=等级不同
    "status_message": "您还不是此商家的代理，请先申请",
    "can_view_goods": false, // 是否可以查看商品：false=否，true=是
    "need_change_level": false, // 是否需要更换等级：false=否，true=是
    "current_level_id": 0 // 当前等级ID：0=无等级
  }
}

---

2. 通过对接码成为代理

接口地址： /merchantapi/distribution/apply/becomeagentbybindcode

请求方式： POST

请求参数：

参数名	类型	必填	说明
code	string	是	对接码

响应示例：

{
  "code": 1,
  "msg": "申请成功，已成为该商家的代理"
}

业务规则：

• 不能对接自己
• 不能重复申请
• 自动通过审核

---

3. 更换代理等级

接口地址： /merchantapi/distribution/apply/changeagentlevel

请求方式： POST

请求参数：

参数名	类型	必填	说明
code	string	是	新的对接码

响应示例：

{
  "code": 1,
  "msg": "代理等级更换成功"
}

业务规则：

• 只能更换已有代理关系的等级
• 更换等级后，已对接商品的成本价会根据新等级重新计算
• 会自动下架自己及下级所有商品
• 需要重新确认价格后上架

---

4. 通过对接码查看上级可代理商品（兼容旧接口）

该接口在后端注释中标记为“作废接口”，原因是无法隐藏未设置代理价格的商品。新流程建议使用“搜索对接码/成为代理”后，再通过 /merchantapi/distribution/agentrelation/goodsListByParentId 查询上级商品。

接口地址： /merchantapi/distribution/apply/goodsListByBindCode

请求方式： POST

请求参数：

参数名	类型	必填	说明
code	string	是	对接码
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "merchant": {
      "merchant_username": "商户A",
      "shop_name": "商户A的店铺"
    },
    "goods_list": [
      {
        "id": 1,
        "user_id": 1000,
        "name": "商品名称",
        "sort": 0,
        "status": 1,
        "stock_quantity": 100,
        "agent_price": "12.00",
        "is_docked": 0,
        "stock": 100
      }
    ],
    "total": 1
  }
}

特殊规则：

• 当前用户必须已经是该对接码所属商户的代理，否则返回“您还不是此商户的代理，无法查看”
• 上级商户注销或冻结时不可查看
• 未设置代理价的商品仍可能出现在列表中，并将 agent_price 返回为“上级暂未设置价格，不可对接”