兑换码

兑换码用于领取重置卡。用户领取后，可以自行决定何时使用卡片恢复额度。领取兑换码不会立刻重置用量。

创建兑换码

在后台的兑换码页面创建，主要参数如下：

参数	含义
生成数量	本次生成多少个兑换码，最多 200 个
自定义码	单个创建时可填写；批量生成使用随机码
可领取数量	一个兑换码最多发放多少张卡
卡片有效天数	从领取时开始计算的重置卡有效期
兑换截止时间	超过后不能再领取；未设置时不过期

每个账号对同一个兑换码只能领取一次，每次获得一张卡。例如可领取数量为 10，表示最多供 10 个不同账号各领取一次。

这里没有“自定义前缀后自动拼接”的表单规则。自定义的是完整兑换码；批量创建不支持指定同一个自定义码。

领取与使用

用户在 /usage 输入兑换码，领取的卡会出现在可用卡片中。使用一张卡后，该卡不能再次使用。

额度重置作用于计数，不删除历史用量账本，也不提高管理员配置的上限。

查看与删除

列表展示已领取数量、总数量和有效期。数量耗尽或超过截止时间后，不能继续领取。

删除兑换码会停止后续领取，已经领取到用户账户中的卡片不会被自动追回。

兑换失败

检查兑换码是否存在、是否过期、是否已领完，以及该账号是否已经领取过。连续尝试错误兑换码会受到限制，应等待提示的时间后再试。

实际用户接口为 POST /api/usage/redeem；使用卡片的接口为 POST /api/usage/cards/{id}/use，都需要登录会话。

如果卡片已消耗但额度重置因数据库错误失败，保留时间与账号信息，由管理员检查并处理。