稳定、快速、高效的 数据接口服务
当前接口状态 · 正常
查询卡密绑定的所有设备及在线状态
接口地址: https://juskey.com/api.php?api=kmdevicelist
返回格式: JSON
请求方式: GET
请求示例: https://juskey.com/api.php?api=kmdevicelist 复制示例 跳转示例
请求参数说明:
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 填写kmdevicelist |
| 应用 | app | 是 | GET | 填写后台应用APPID |
| 卡密 | kami | 是 | GET/POST | 填写提交的卡密 |
| 设备码 | markcode | 是 | GET/POST | 当前设备的机器码(权限验证) |
| 时间戳 | t | 否 | GET/POST | 如果开启了时间差效验需提交 |
| 数据签名 | sign | 否 | GET/POST | 如果开启了数据签名需提交 |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| code | String | 返回状态 |
| kami | String | 查询的卡密 |
| total | Number | 已绑定设备数量 |
| max | Number | 最大设备限制 |
| devices | Array | 设备列表: mac,status,online,time,date,ip |
返回示例:
错误码格式说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
| 112 | String | 设备码为空 |
| 148 | String | 卡密为空 |
| 149 | String | 卡密不存在 |
| 151 | String | 卡密已禁用 |
| 201 | String | 无权限查看 |
代码示例:
请求示例:
解密后: kami=ABC123DEF&markcode=当前设备码&t=1700000000返回示例:
{ "code": 200, "msg": { "kami": "ABC123DEF", "total": 5, "max": 10, "devices": [ {"mac":"MACHINE_A","status":"心跳请求成功","online":true,"date":"2024-06-14","ip":"192.168.1.100"}, {"mac":"MACHINE_B","status":"卡密登录成功","online":false,"date":"2024-06-13","ip":"10.0.0.5"} ] } }