1.用途

查询登录用户下所有的设备列表
采用Post方式，请求参数为JSON格式

2.URL

http://124.223.60.234:8181/spartan/device/queryUserDevices

3.请求参数

3.1.参数示例

{
    "userId":"21"
}

3.2.参数说明

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

4.返回参数

4.1.返回参数示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": [
        {
            "userId": "21",
            "terminalId": "1957EE0C69614AB3B3AF2755103B0AB6",
            "terminalName": "344050190425",
            "terminalNum": "344050190425",
            "terminalColor": "",
            "gnssTime": "2023-01-31 02:21:10",
            "gnssTimestamp": 1675131670000,
            "lat": 0.0,
            "lon": 0.0,
            "dir": 0,
            "onlineStatus": 0,
            "authority": 0,
            "deviceTags": [
                {
                    "tagId": "B51A56CB0AAA4C168B7F069E2C0E12C1",
                    "tagName": "First Filter Tag",
                    "tagColor": "rgba(53, 106, 195, 0.8)"
                }
            ]
        },
        {
            "userId": "21",
            "terminalId": "589D6C6B4678434FB962971BA8513432",
            "terminalName": "162070003356",
            "terminalNum": "162070003356",
            "terminalColor": "",
            "gnssTime": "2023-03-26 09:38:22",
            "gnssTimestamp": 1679823502000,
            "lat": 0.0,
            "lon": 0.0,
            "dir": 0,
            "onlineStatus": 0,
            "authority": 0,
            "deviceTags": [
                {
                    "tagId": "B51A56CB0AAA4C168B7F069E2C0E12C1",
                    "tagName": "First Filter Tag",
                    "tagColor": "rgba(53, 106, 195, 0.8)"
                }
            ]
        },
        {
            "userId": "21",
            "terminalId": "5FAEC559FA18489B97581877FD7FA29B",
            "terminalName": "162070003357",
            "terminalNum": "162070003357",
            "terminalColor": "",
            "gnssTime": null,
            "gnssTimestamp": 0,
            "lat": 0.0,
            "lon": 0.0,
            "dir": 0,
            "onlineStatus": 0,
            "authority": 0,
            "deviceTags": [
                {
                    "tagId": "B51A56CB0AAA4C168B7F069E2C0E12C1",
                    "tagName": "First Filter Tag",
                    "tagColor": "rgba(53, 106, 195, 0.8)"
                }
            ]
        }
    ]
}

4.2.返回参数说明

字段 类型 说明
code int 返回状态，详情参见“返回状态集”
message String 返回结果描述
data List 返回结果体
data说明
字段 类型 说明
userId String 用户ID
terminalId String 设备ID
terminalName String 设备名称
terminalNum String S/N码
terminalType int 设备类型ID，100：VM-400
terminalTypeName String 设备类型名称，即：VM-400
modelId int 设备所属的分类；1：V系列；2：G系列；3：A系列
terminalColor String 设备颜色
imei String IMEI
iccid String ICCID
gnssTime String 设备上报数据时间（UTC）
gnssTimestamp long 设备上报数据时间戳
lat double 纬度(WGS84)
lon double 经度(WGS84)
dir int 方向(0~360),0代表正北
onlineStatus int 在网状态（0：未在网；1：联网中）
authority String 权限（0:Owner;1:Guest;2:Admin）
deviceTags List 设备关联的Filter tag列表
deviceTags说明
字段 类型 说明
tagId String filter tag id
tagName int filter tag name
tagColor String 颜色（RGB）
### 5.测试示例
作者：admin  创建时间：2023-03-22 15:23
最后编辑：admin  更新时间：2024-06-13 09:41