1.URL

xxxxxxxxxxxxxxx/system/asset/terminal/queryTerminalInfo
其中xxxxxxxxxxxxxxx为节点URL（详情参考：对接说明中4.服务器节点说明）
（上海节点）http://124.223.60.234:8080/system/asset/terminal/queryTerminalInfo
（美国节点）https://cloud.aovx.com/prod/system/asset/terminal/queryTerminalInfo

2.请求参数

2.1请求头

在Headers里面增加token:对应登录验证成功后，data里面对应的tokenId

2.2.参数示例

{
    "terminalId":"7EC4BA707DA04EF59CEC34396EFEA18D"
}

2.3.参数说明

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

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "id": "4AC85A90D6774F978C76C315D62EB8C1",
        "terminalNum": "959069906050",
        "customNum": "6050",
        "orgId": "0CFBA0137FE449038D461A959C01641F",
        "orgName": "SSBC",
        "vehicleId": "",
        "vehicleNum": null,
        "iconType": null,
        "typeId": 105,
        "typeName": "SS808",
        "protocolType": 808,
        "simNum": "",
        "iccid": "",
        "imei": "",
        "status": 1,
        "descInfo": "",
        "expireTime": "2024-11-01 00:00:00",
        "createTime": "2023-11-17 09:39:34",
        "creatorId": "FA3618315CE34FEDBE0505E9107E6F1E",
        "creator": "ssbc",
        "terminalStatus": {
            "onlineStatus": 1,
            "battery": 98,
            "shutdown": 0,
            "locType": 0,
            "lat": 0.0,
            "lon": 0.0,
            "speed": 0.0,
            "dir": 0,
            "mil": 0.0,
            "gtime": "2023-11-20 07:45:25",
            "rtime": "2023-11-20 07:45:41",
            "alarms": []
        }
    }
}

3.2.返回结果说明

字段 类型 说明
code int 返回状态
message String 返回结果描述
data object 返回结果体

data说明

字段 类型 说明
total String 总条数
size String 多少页
data object 每页的结果集合

data说明

字段 类型 说明
id String 终端系统唯一标识
terminalNum String 终端SID
customNum String 终端自定义编号，可由客户自己定义
orgId String 公司唯一标识
orgName String 公司名称
vehicleId String 车辆或者被监控的资产唯一标识
vehicleNum String 车辆或者被监控的资产编码
iconType int 图标类型
typeId Integer 终端类型ID
typeName String 终端类型名称
simNum String SIM卡号
iccid String ICCID
imei String IMEI
status Integer 终端状态（0:禁用；1:启用）
descInfo String 终端描述
expireTime String 终端服务到期时间
createTime String 终端注册时间
creatorId String 终端注册人唯一标识
creator String 终端注册人
terminalStatus object 终端实时状态
terminalStatus说明
字段 类型 说明
onlineStatus int -1:未激活；0：未联网；1：联网中
battery int 电量百分比
software_version String 软件版本
speed double 速度值，单位：km/h
alarms List 报警集合，详情参见报警报告下面的报警类型清单
gnssTime String 设备最新上报定位数据的时间（UTC）
recvTime String 系统接收设备最新上报定位数据的时间（UTC）
shutdown int 关机状态（0：开机；1：关机中）
workModel String 工作模式：0：周期模式；1： 触发模式；2： 跟踪模式+触发模式；3： 时钟模式+触发模式；4： 周期模式+触发模式;5:智能模式；6：超级省电

4.请求示例

作者：admin  创建时间：2023-11-20 15:39
最后编辑：admin  更新时间：2025-07-21 21:32