查询设备信息
概述
提供指定设备的完整信息查询服务，返回设备基础信息。
接口地址
http://api.xvista.cc:9999/largespace/public/v1/select/device/info
请求方法
- GET
请求参数
url参数：
http://api.xvista.cc:9999/largespace/public/v1/select/device/info?access_token=00000000000000&sn="000000"
| 参数 | 必选 | 值 |
|---|---|---|
| access_token | 是 | 通过Secret Key获取的access_token，参考"获取access_token" |
| sn | 是 | 设备PicoSN |
Body参数：
- 此项无参数
返回示例
成功返回：
{
"code": 1,
"message": "success",
"data": {
"sn": "PA9410MGJ0000000G",
"name": "权限测试1-PA9410MGJ0000000G",
"type": "PICO 4 Ultra Enterprise",
"notes": "",
"belong_store": {
"name": "测试店铺1",
"store_id": "3675335774"
},
"device_ip": "0.0.0.0",
"device_believable_time": "1000000000",
"device_play": {
"value": "1",
"msg": "已开始"
},
"device_packege": "com.xx.xx",
"device_electricity": "0",
"device_team": {
"value": "2",
"msg": "组队游玩"
},
"device_playtime": "1000000000",
"device_progress": "0/0"
},
"timestamp": 1750100824660,
"executeTime": 390
}
| 参数 | 类型 | 值 |
|---|---|---|
| sn | string | 设备PicoSN |
| name | string | 设备名称 |
| type | string | 设备类型 |
| notes | string | 备注 |
| belong_store | json | - |
| -name | string | 店铺名 |
| -store_id | string数组 | 店铺ID |
| device_ip | string | 设备ip |
| device_believable_time | string | 数据可信时间 |
| device_play | json | - |
| -value | string | 状态类型 |
| -msg | string | 状态 |
| device_playtime | string | 最近一次启动游戏时间 |
| device_progress | string | 游戏进度【当前进度/总进度】 |
[!TIP] 返回值device_progress“游戏进度”处于开发状态，目前固定为0/0，预计2025年6月19前可用
除"data"外的其他参数，可以在“通用说明-统一请求响应”中找到说明
错误返回：
| code | message | 解释 |
|---|---|---|
| 400 | 设备不存在 | 设备PicoID不正确，检查设备PicoID是否正确 |
通用异常可以在“通用说明-统一异常处理”中找到说明
备注
- 暂无