GET /api/redeem-codes
请求
| 项 | 内容 |
|---|---|
| 方法 | GET |
| 路径 | /api/redeem-codes |
| 鉴权 | 管理员高级版 |
Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
Authorization | Header | string | 是 | Bearer <jwt>。 |
Content-Type | Header | string | 否 | 无请求体时不需要。 |
Path 参数
无。
Query 参数
无。
Body 参数
无。
返回值
兑换码列表。
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | number | 兑换码 ID。 |
code | string | 兑换码。 |
amount | string/number | 兑换后直接增加的余额,可为 0。 |
group_id | number/null | 授予的用户组 ID。 |
group | object | 用户组对象。 |
group_duration_days | number | 用户组有效天数,0 表示永久。 |
subscription_plan_id | number/null | 授予的订阅套餐 ID。 |
subscription_plan | object/null | 订阅套餐对象。 |
subscription_duration_days | number | 订阅有效天数,0 表示永久。 |
allow_stacking | boolean | 同组或同套餐权益是否叠加有效期。 |
max_uses | number | 最大可用次数,0 表示不限。 |
used_count | number | 已使用次数。 |
enabled | boolean | 是否启用。 |
expires_at | string/null | 兑换码过期时间。 |
created_at | string | 创建时间。 |
updated_at | string | 更新时间。 |
错误
| 状态码 | 说明 |
|---|---|
400 | 参数不合法。 |
401 | 未登录或登录失效。 |
403 | 无权限。 |
404 | 资源不存在。 |
500 | 服务端错误。 |