# 以卡续卡

# 简要描述
  • 用全新未使用卡密续费旧的已使用卡密,卡密需要同一个设备类型(单设备只能续费单设备),续费后新的卡密到期时间为当前,卡密备注自动修改
# 请求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验签此参数必传,且2分钟内不允许重复)
# 请求方式
  • 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 更新对象
code String 二维码(base64格式,需要转为图片)
nonce string 随机字符串(当开启V3验签必返回次参数,且2分钟内不会重复)
sign string 此参数如果在app设置开启了验签是必返
reqSign string 请求签名
time long 当开启验签时,此参数为必返回
exTime string 被续费卡密到期时间
renewalCardStr string 续费卡密
cardStr string 被续费卡密
# 备注
  • 更多返回错误代码请看首页的错误代码描述