接口 - 用户使用兑换码
接口名称:redeem_code.exchange
用于在网站App内自行实现兑换码界面和交互逻辑。
调用此接口前需通过 获取用户信息 接口取得 customer_id 参数。
请求参数:
{
"customer_id": "13537457560670044000", // 艺爪系 统用户ID
"value": "xxx" // 兑换码值
}
成功响应(HTTP状态码 200 ):
{
"project_id": "bsq0h8h32rzm4", // 项目ID
"value": "BGQG6KD70FZQ", // 兑换码值
"product": { // 兑换商品信息
"id": "pgf7wquxuude8", // 商品ID
"name": "单月会员" // 商品名称
}
}
失败响应(HTTP状态码 400 ):
{
"error": "RedeemCodeInvalid", // 错误码
"message": "", // 错误信息
"detail": null
}
相关错误码
| 错误码 | 描述 |
|---|---|
| RedeemCodeAlreadyUsed | 兑换码已用过 |
| RedeemCodeExhausted | 兑换码已用完 |
| RedeemCodeExpired | 兑换码已过期 |
| RedeemCodeInvalid | 兑换码无效 |
| 其他值 | 未知错误 |