1. 我购买的邀请码列表

接口地址： /merchantapi/distribution/hall/myBuyHallCodeList

请求方式： POST

请求参数：

参数名	类型	必填	说明
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 2,
        "code": "KzgcGm7s",
        "status": 1,
        "used_user_id": 1002, // 使用者ID
        "user_id": 1000, // 购买者ID
        "used_time": 1763896066, // 使用时间
        "create_time": "2025-11-23 19:06:37", // 购买时间
        "update_time": "2025-11-23 19:07:46", // 更新时间
        "used_username": "test1002", // 使用者用户名
        "status_text": "已使用" // 状态文本：未使用/已使用
      }
    ],
    "total": 10
  }
}

---

2. 获取邀请码单价

接口地址： /merchantapi/distribution/hall/getCodePrice

请求方式： POST

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "price": 10 // 邀请码单价
  }
}

---

3. 购买邀请码

接口地址： /merchantapi/distribution/hall/buyHallCode

请求方式： POST

请求参数：

参数名	类型	必填	说明
quantity	int	是	购买数量

响应示例：

{
  "code": 1, // 1=成功，0=失败
  "msg": "购买成功" // 其他：购买失败：您没有货源大厅访问权限，无法购买邀请码/购买失败：购买数量必须大于0/购买失败：运营钱包余额不足，请先充值
}

业务规则：

• 需要有足够的可用运营资金余额
• 购买后会扣除运营资金，并记录资金日志，业务类型为：buy_hall_code
• 购买成功后会发送站内消息，内容为：您已成功购买' . $quantity . '个货源大厅邀请码，总计花费' . $total_price . '元。

---

4. 核销邀请码

接口地址： /merchantapi/distribution/hall/verifyHallCode

请求方式： POST

请求参数：

参数名	类型	必填	说明
code	string	是	邀请码

响应示例：

{
  "code": 1, // 1=成功，0=失败
  "msg": "核销成功，已为您开通货源大厅功能", // 其他：邀请码已使用/邀请码不存在/核销成功，但您的信誉分不足80，无法开通货源大厅访问权限
  "data": {
    "hall_access": 1 // 货源大厅访问权限：0=未开通，1=已开通
  }
}

业务规则：

• 邀请码必须存在且未使用
• 核销成功后增加信誉分
• 信誉分达到 80 分才能开通货源大厅访问权限
• 核销成功后发送站内消息