接口 - 用户使用兑换码
接口名称: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 | 兑换码无效 |
其他值 | 未知错误 |