# 以卡续卡

# 简要描述
  • 用全新未使用卡密续费旧的已使用卡密,卡密需要同一个设备类型(单设备只能续费单设备),续费后新的卡密到期时间为当前,卡密备注自动修改
# 请求URL
  • /api/renewalCard
# 请求头
参数名 必选 类型 说明
Content-Type 是 string 此参数必传,当请求数据非json时此参数传对应格式如(multipartform-data,application/x-www-form-urlencoded,等)是json请传application/json
askKey 是 string 此参数必传,验证app的令牌
sign 否 string 此参数如果在app设置开启了验签是必传
time 否 string 当开启验签时,此参数为必传
apiUserToken 否 string 用户令牌
nonce 否 string 随机字符串(当开启V3验签此参数必传,且6分钟内不允许重复)
# 请求方式
  • post
# 参数
参数名 必选 类型 说明
cardStr 是 string 被续费卡密
renewalCardStr 是 string 续费卡密
# 请求示例
{
    "cardStr":"QCR387",
    "renewalCardStr":"F2T45H"
}

1
2
3
4
5
# 返回示例
{
	"code": "200",
	"data": {
		"cardStr": "QCR387",
		"renewalCardStr": "7NR2SD",
		"exTime": "1970-01-02 08:00:00"
	},
	"time": 1781671368566,
	"message": "",
	"status": true
}
1
2
3
4
5
6
7
8
9
10
11
# 返回参数说明
参数名 类型 说明
code string 状态码200成功403权限异常或登录超时,500请求异常
status int 状态0删除1使用
data json 返回数据
nonce string 随机字符串(当开启V3验签必返回次参数,且6分钟内不会重复)
sign string 此参数如果在app设置开启了验签是必返
reqSign string 请求签名
time long 当开启验签时,此参数为必返回
exTime string 被续费卡密到期时间
renewalCardStr string 续费卡密
cardStr string 被续费卡密
# 备注
lastUpdate: 9/3/2026, 5:11:12 PM