查询兑换码详情

更新于 2025-07-18

通过兑换码查询接口可获取兑换码状态、关联权益和有效期等信息，便于校验兑换结果与排查异常。

接口调用

说明

接口描述	查询某个兑换码的相关详情，需调用此接口。兑换码从接口中传入{redeemCode}
请求域名	https://ai-user-api.jbangai.com
接口地址	/api/open/vip/redeem/v2/{redeemCode}/detail
请求方式	GET
权限校验	是

提交参数

Header请求头

参数	类型	是否必传	参数说明
Access-Token	string	是	从获取令牌中获取到对应的参数值accessToken，详情请查看文档

请求示例

              
            

              curl --location --request GET 'https://ai-user-api.jbangai.com/api/open/vip/redeem/v2/l1v47kvw/detail' \
  --header 'Access-Token: eyJhbGciOiJIUzUxMiJ9...' \
  --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
  --header 'Accept: */*' \
  --header 'Host: ai-user-api.jbangai.com' \
  --header 'Connection: keep-alive'
            

返回参数

参数	子参数	子子参数	类型	说明
code	—	—	string	响应编码
data	redeemTitle	—	string	兑换码名称
	redeemTime	—	string	已兑换时间
	expireTime	—	string	兑换码兑换截止时间
	status	—	string	兑换状态（used-已兑换，unused-未兑换）
	createTime	—	string	兑换码创建时间
	targetObject	nickname	string	已兑换的用户信息
message	—	—	string	返回提示信息
serverTime	—	—	string	当前时间戳

响应示例

              
            

              {
  "code": 0,
  "data": {
    "redeemTitle": "年度会员兑换码",
    "redeemTime": "2025-05-23T05:24:18.000+00:00",
    "expireTime": "2030-05-29T16:00:00.000+00:00",
    "status": "used",
    "createTime": "2025-05-22T08:41:42.000+00:00",
    "targetObject": {
      "nickname": "匠邦教案"
    }
  },
  "message": "",
  "serverTime": 1750648809
}
            