# 以卡续卡
# 简要描述
- 用全新未使用卡密续费旧的已使用卡密,卡密需要同一个设备类型(单设备只能续费单设备),续费后新的卡密到期时间为当前,卡密备注自动修改
# 请求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
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
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 | 被续费卡密 |
# 备注
- 更多返回错误代码请看首页的错误代码描述