POST /api/user/redeem-code

请求

项	内容
方法	POST
路径	/api/user/redeem-code
鉴权	登录用户高级版

Header 参数

参数	位置	类型	必填	说明
Authorization	Header	string	是	Bearer <jwt>。
Content-Type	Header	string	是	application/json。

Path 参数

无。

Query 参数

无。

Body 参数

参数	位置	类型	必填	说明
code	Body	string	是	兑换码或 OIDC code，按接口语义使用。

返回值

兑换结果。

返回字段

字段	类型	说明
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	服务端错误。