1.用途

查看设备状态数据的时候设备的基础信息
采用Post方式，请求参数为JSON格式

2.URL

http://124.223.60.234:8181/spartan/device/queryDeviceInfo

3.请求参数

3.1.参数示例

{
    "terminalId":"589D6C6B4678434FB962971BA8513432",
    "userId":"21"
}

3.2.参数说明

字段 类型 说明 是否必须
userId String 用户的唯一标识 Y
terminalId String 设备的唯一标识 Y

4.返回参数

4.1.返回参数示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "terminalId": "589D6C6B4678434FB962971BA8513432",
        "terminalName": "162070003356",
        "terminalNum": "162070003356",
        "terminalColor": "",
        "iccid": "162070003356",
        "imei": "162070003356",
        "terminalType": 100,
        "terminalTypeName": "VM-400",
        "autoUpdate":0,
        "firmware": "AOVX_VX3xx-XX_H2.0_V2.0.3_v02",
        "vehicleId": "E2E31F548BBC47D29BEA6B7124BD3F69",
        "updateNum": 1,
        "shareCount": 1,
        "markLost":0,
        "shareList": [
            {
                "shareId": "DB14F3C6FC47453DB5F519D82C641F2A",
                "shareUserId": "22",
                "shareEmail": "daoxunchang@foxmail.com",
                "shareName": "Mr.Lee",
                "authority": 1
            }
        ],
        "deviceTags": [
            {
                "tagId": "B51A56CB0AAA4C168B7F069E2C0E12C1",
                "tagName": "First Filter Tag",
                "tagColor": "rgba(53, 106, 195, 0.8)"
            }
        ],
        "firmwares": [
            {
                "firmwareId": "5FAEC559FA18489B97581877FD7FA30B",
                "firmware": "AOVX_AX300-XX_H2.0_V2.0.5_v09",
                "type": 0,
                "mode": 0,
                "protocol": 1,
                "fileUrl": "http://124.223.60.234:8888/AOVX_AX300-XX_H2.0_V2.0.5_v09.bin",
                "size": 132.7,
                "pushTime": "2023-03-23 13:31:17",
                "descInfo":"xxxxxxxxxxxxxx"
            }
        ]
    }
}

4.2.返回参数说明

字段 类型 说明
code int 返回状态，详情参见“返回状态集”
message String 返回结果描述
data Objetc 返回结果体
data说明
字段 类型 说明
terminalId int 设备ID
terminalName String 设备名称
terminalNum String S/N码
terminalColor String 设备颜色
imei String IMEI
iccid String ICCID
terminalType int 设备类型ID，100：VM-400
terminalTypeName String 设备类型名称，即：VM-400
modelId int 设备所属的分类；1：V系列；2：G系列；3：A系列
manufactor String 生产厂家
vehicleId String 绑定的车辆唯一标识
autoUpdate int 是否开启自动更新固件，0：未开启；1：已开启
firmware String 当前设备的固件版本
updateNum int 可更新的固件版本数量
firmwares List 可更新的固件信息列表
shareCount int 设备分享的次数
shareList List 被分享的账户信息
deviceTags List 设备关联的Filter tag列表
onlineStatus int (0:未联网；1：联网中)
activeStatus int Active Tracking status;0:disabled;1:enable
authority int 0:Owner;1:Guest;2:Admin
markLost int 标记丢失状态（0：未标记；1：已标记）
firmwares说明
字段 类型 说明
firmwareId String 固件版本唯一标识
firmware String 固件版本号
type String 0: app upgrade;1:core upgrade
mode String 0:full package;1:diff package
protocol String 0：FTP；1：HTTP
fileUrl String 固件的服务器URL
size String 固件大小（kb）
pushTime String 固件推送时间
descInfo String 固件描述
shareList说明
字段 类型 说明
shareId String 分享记录的唯一标识
shareUserId String 接受分享的账户ID
shareEmail String 接受分享的账户邮件地址
shareName String 接受分享的用户名
authority int 分享的权限(1:Guest;2:Admin)
deviceTags说明
字段 类型 说明
tagId String filter tag id
tagName int filter tag name
tagColor String 颜色（RGB）

5.测试示例

作者：admin  创建时间：2023-03-22 15:45
最后编辑：admin  更新时间：2024-10-22 11:12