跳到主要内容

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
  • 409 REDUNDANT_PERMANENT_PURCHASE
  • 409 PERMANENT_TAIL_CONFLICT
  • 400 INVALID_PLAN_VALUE
  • 400 INVALID_SUBSCRIPTION_CHAIN