跳到主要内容

接口 - 用户使用兑换码

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