POST-http://api.hwwlyz.com/api/v1/card/login
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的appKey |
| card | 是 | string | 登录的卡密 |
| deviceId | 是 | string | 用户的设备唯一标识码 |
| timestamp | 是 | int64 | 时间戳，秒级（10位数） |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "ok",
"data": {
"cardType": "半月",
"token": "1lb87kk1kq9kr6cy45oqg2hu7kd00b9g",
"expires": "2024-01-15 19:47:48",
"expiresTs": 1705319268,
"config": "",
"serverTime": 1704196636
}
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
| data | object | 请求正确时，若有额外数据要返回，则结果封装在该字段。若无额外数据，则无此字段。 |
| cardType | string | 卡密类型 |
| token | string | 本次登录的标识，鉴权用的令牌 |
| expires | string | 卡密过期时间，格式化的 |
| expiresTs | int64 | 过期时间戳，秒级（10位数） |
| config | string | 卡密的配置 |
| serverTime | int64 | 服务器当前时间戳，秒级（10位数） |
接口说明 用于保持登录状态，刷新token的有效期，token在超过3分钟(该值可在软件配置页面更改)未收到心跳请求将自动失效。 建议每隔1分钟(也就是token有效期的三分之一)调用一次
POST-http://api.hwwlyz.com/api/v1/card/heartbeat
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的appKey |
| card | 是 | string | 登录的卡密 |
| timestamp | 是 | int64 | 秒级时间戳，10位的 |
| token | 是 | string | 登录成功后返回的令牌 |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "ok",
"data": {
"expires": "2020-10-16 00:47:58",
"expiresTs": 1602780478,
"serverTime": 1574654207
}
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
| data | object | 请求正确时，若有额外数据要返回，则结果封装在该字段。若无额外数据，则无此字段。 |
| expires | string | 卡密过期时间，格式化的 |
| expiresTs | int64 | 过期时间戳，秒级，10位的 |
| serverTime | int64 | 服务器当前时间戳，秒级，10位的 |
POST-http://api.hwwlyz.com/api/v1/card/heartbeatLogout
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的appKey |
| card | 是 | string | 登录的卡密 |
| timestamp | 是 | int64 | 时间戳， 秒级，10位的 |
| token | 是 | string | 登录成功后返回的令牌 |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "",
"data": null
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
说明 请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。
POST-http://api.hwwlyz.com/api/v1/card/unbindDevice
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的appKey |
| card | 是 | string | 登录的卡密 |
| deviceId | 是 | string | 用户的设备唯一标识码 |
| timestamp | 是 | int64 | 秒级时间戳，10位的 |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "",
"data": null
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
说明 请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。 该密码用于绑定设备丢失或者其它原因导致无法在老设备登录时解绑设备。
POST-http://api.hwwlyz.com/api/v1/card/setUnbindPassword
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的appKey |
| card | 是 | string | 登录的卡密 |
| password | 是 | string | 解绑密码，6-10位 |
| timestamp | 是 | int64 | 秒级时间戳，10位的 |
| token | 是 | string | 登录成功后返回的令牌 |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "",
"data": null
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
说明 请先进入开发者后台软件管理页面，配置软件开启设备绑定且可解除绑定。 该接口用于绑定设备丢失或者其它原因导致无法在老设备登录时，通过解绑密码解绑设备。
POST-http://api.hwwlyz.com/api/v1/card/unbindPassword
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的appKey |
| card | 是 | string | 登录的卡密 |
| password | 是 | string | 解绑密码，6-10位 |
| timestamp | 是 | int64 | 秒级时间戳，10位的 |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "",
"data": null
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
POST-http://api.hwwlyz.com/api/v1/card/recharge
| 参数名 | 是否必需 | 类型 | 参数说明 |
|---|
| appKey | 是 | string | 软件的 appKey |
| card | 是 | string | 被充值的卡密（长度不超过 45 位） |
| timestamp | 是 | int64 | 时间戳，秒级（10 位数） |
| useCard | 是 | string | 充值使用的卡密（长度不超过 45 位） |
| sign | 是 | string | 签名 |
{
"code": 0,
"message": "",
"data": null
}
| 参数名 | 类型 | 参数说明 |
|---|
| code | int | 返回码，0 表示正确，详细参照返回码对照表 |
| message | string | 请求出错时的错误信息 |
