跳到主要内容

POST /api/public/v1/me/redemptions

为当前登录客户本人兑换卡密。不能指定其他客户。

请求体

{
"code": "ABC-DEF-GHI"
}

成功响应

HTTP 状态码 201

{
"ok": true,
"requestId": "req_123",
"data": {
"customer": {
"id": 1,
"username": "customer_001",
"created": false
},
"subscriptions": [
{
"id": 10,
"planId": 2,
"planName": "Pro",
"validFrom": "2026-03-21T00:00:00.000Z",
"validTo": "2026-04-21T00:00:00.000Z"
}
]
}
}

可能错误

  • 404 CODE_NOT_FOUND
  • 409 CODE_ALREADY_REDEEMED