1. 获取推广统计数据

接口地址： /merchantapi/user/assistant/statistics

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_invites": 100,
    "total_rebate": "500.00",
    "month_invites": 10,
    "month_rebate": "50.00"
  }
}

字段说明：

• total_invites: 累计邀请数 （不遵循数据时效性）
• total_rebate: 累计返佣金额 （它会遵循数据时效性，比如如果商户设置的 7 天，则本月的最大数据展示只有 7 天内的数据）
• month_invites: 本月邀请数 （不遵循数据时效性）
• month_rebate: 本月返佣金额 （不遵循数据时效性）

---

2. 获取推广链接

接口地址： /merchantapi/user/assistant/getSpreadLink

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "spread_link": "https://example.com?spreadId=123",
    "spread_id": 123,
    "username": "商户A",
    "spread_rate": "0.05"
  }
}

字段说明：

• spread_link: 推广链接
• spread_id: 推广 ID（用户 ID）
• username: 用户名
• spread_rate: 推广返佣比例（5%）

---

3. 获取邀请记录列表

接口地址： /merchantapi/user/assistant/inviteList

请求方式： POST

请求参数：

参数名	类型	必填	说明
date_range	array	否	日期范围
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 1047, // 被邀请用户ID
        "parent_id": 1000, // 推广人ID
        "create_at": "2025-11-24 18:41:26", // 邀请时间
        "username": "test1047" // 被邀请用户名
      }
    ],
    "total": 1
  }
}

---

4. 获取返佣明细列表

接口地址： /merchantapi/user/assistant/rebateList

请求方式： POST

请求参数：

参数名	类型	必填	说明
date_range	array	否	日期范围
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 123,
        "business_type": "spread_rebate_freeze", // 返佣日志资金业务类型，此处一定为spread_rebate_freeze
        "type": "freeze_money", // 变动钱包类型，仅发生订单交易时冻结推广佣金，故 type一定为freeze_money
        "money": "5.00", // 返佣金额
        "balance": "105.00", // 变动后余额
        "reason": "邀请用户456注册返佣", // 返佣说明
        "create_at": 1699999999 // 创建时间
      }
    ],
    "total": 50
  }
}

---

5. 获取推广海报配置

接口地址： /merchantapi/user/assistant/getposter

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "spread_link": "https://example.com?spreadId=123", // 推广链接
    "spread_id": 123, // 推广 ID
    "username": "商户A", // 用户名
    "title": "邀请好友开店", // 海报标题
    "description": "邀请好友注册开店，享受订单返佣" // 海报描述
  }
}