## 已售套餐用户 (`user-package-owners`)

仅管理员:按用户归组的已售套餐列表(套餐数、到期统计、页签计数)。

鉴权: 仅管理员 · 文档: https://www-sa2.kuxitong.com/zh/docs/api/user-package-owners

### GET `/api/v2/user-package-owners`

按用户列出已售套餐 · 鉴权: 仅管理员

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `page` | integer |  | 页码,从 1 开始。 默认: 1 |
| `page_size` | integer |  | 每页条数。 默认: 20 |
| `tab` | string |  | 页签:all 全部、week 7 天内到期(未过期)、month 30 天内到期(未过期)、expired 已过期、customized 已定制(单独改过额度或不跟随基础套餐);缺省 all。 可选值: ["all","week","month","expired","customized"] |
| `q` | string |  | 关键词:用户名、套餐名称或基础套餐名称包含(% _ 按字面匹配),或等于用户 ID / 套餐 ID。 |

```sh
curl "https://panel.example.com/api/v2/user-package-owners" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

已售套餐用户对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `avatar_ver` | integer |  | 头像版本,每次上传变大,作取头像的缓存键;没有头像时缺省。 |
| `expired_count` | integer |  | 其中已过期的套餐数。 |
| `expiring_count` | integer |  | 其中 7 天内到期(未过期)的套餐数。 |
| `next_end_at` | string |  | 页签内最近一个未过期套餐的到期时间;全部已过期时缺省。 |
| `nickname` | string |  | 昵称;没设时缺省(界面显示登录名)。 |
| `package_count` | integer |  | 页签内的套餐数。 |
| `user_id` | integer |  | 用户 ID(即租户 ID)。 |
| `username` | string |  | 登录名。 |
