1.URL

http://124.223.60.234:8080/system/asset/terminal/queryTerminalInfoList

2.请求参数

2.1请求头

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

2.2.参数示例

{
    "ids":["8F2744CF926044CF8E5B44D2BF7D0BF0"]
    "keyType":0,
    "key":"",
    "status":0,
    "pageNum":1,
    "pageSize":20
}

批量查询示例:

{
    "ids":["8F2744CF926044CF8E5B44D2BF7D0BF0"]
    "keyType":1,
    "key":"344050190425,13100000008",
    "status":0,
    "pageNum":1,
    "pageSize":20
}

2.3.参数说明

字段 类型 说明 是否必须
ids List 公司组织ID集合 Y
key String 模糊查询Key,如果是按终端ID号批量查询则用英文半角逗号隔开 Y
keyType int 0:是按模糊查询;1:通过终端ID批量查询 Y
status int 查询终端状态(0:全部;1:正常;2:禁用;3:已到期) Y
pageNum int 分页查询当前页码,默认1 Y
pageSize int 分页查询每页显示条数,默认20 Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 7,
        "size": 1,
        "data": [
            {
                "id": "3D6F016301864042BF6336762270DA88",
                "terminalNum": "13100000008",
                "customNum": "008",
                "orgId": "199D9E6F70114AD3A36ACA6A9742B66D",
                "orgName": "国内客户",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000008",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试008",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 04:50:41",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            },
            {
                "id": "434CB97CF48440E59B3FFDB10D145D9D",
                "terminalNum": "13100000007",
                "customNum": "007",
                "orgId": "199D9E6F70114AD3A36ACA6A9742B66D",
                "orgName": "国内客户",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000007",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试007",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 04:44:15",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            },
            {
                "id": "51FABD9627E04C95B50080600A9194DD",
                "terminalNum": "13100000004",
                "customNum": "004",
                "orgId": "199D9E6F70114AD3A36ACA6A9742B66D",
                "orgName": "国内客户",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000004",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试004",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 04:43:48",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            },
            {
                "id": "9994838FC2F14373879C2AED808DBD27",
                "terminalNum": "13100000009",
                "customNum": "009",
                "orgId": "199D9E6F70114AD3A36ACA6A9742B66D",
                "orgName": "国内客户",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000009",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试009",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 04:44:01",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            },
            {
                "id": "A59C1A764B704CA8B9F8116A5EABCF23",
                "terminalNum": "13100000101",
                "customNum": "101",
                "orgId": "8F2744CF926044CF8E5B44D2BF7D0BF0",
                "orgName": "亿元通讯",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000101",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试101",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 05:24:03",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            },
            {
                "id": "ABF56059F97145599DC76A06EE21F071",
                "terminalNum": "13100000010",
                "customNum": "010",
                "orgId": "199D9E6F70114AD3A36ACA6A9742B66D",
                "orgName": "国内客户",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000010",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试010",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 04:37:47",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            },
            {
                "id": "E32F0B53161E462C90761F589303FFE8",
                "terminalNum": "13100000100",
                "customNum": "100",
                "orgId": "8F2744CF926044CF8E5B44D2BF7D0BF0",
                "orgName": "亿元通讯",
                "vehicleId": "",
                "vehicleNum": null,
                "typeId": 808,
                "typeName": "JT/T808-2013",
                "simNum": "13100000100",
                "iccid": "",
                "imei": "",
                "status": 1,
                "descInfo": "部标测试100",
                "expireTime": "2023-02-01 00:00:00",
                "createTime": "2023-01-11 05:23:44",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "aovx"
            }
        ]
    }
}

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 车辆或者被监控的资产编码
typeId Integer 终端类型ID
typeName String 终端类型名称
simNum String SIM卡号
iccid String ICCID
imei String IMEI
status Integer 终端状态(0:禁用;1:启用;2:服务已到期)
descInfo String 终端描述
expireTime String 终端服务到期时间
createTime String 终端注册时间
creatorId String 终端注册人唯一标识
creator String 终端注册人
terminalStatus object 终端实时状态
terminalStatus说明
字段 类型 说明
onlineStatus int -1:未激活;0:未联网;1:联网中
battery int 电量百分比
software_version String 软件版本
作者:admin  创建时间:2023-04-16 20:04
最后编辑:admin  更新时间:2025-04-23 17:26