1.URL
http://124.223.60.234:8080/system/asset/terminal/queryTerminalInfoListIncludeChild
2.请求参数
2.1请求头
在Headers里面增加token:对应登录验证成功后，data里面对应的tokenId
2.2.参数示例
{
"id":"199D9E6F70114AD3A36ACA6A9742B66D",
"keyType":0,
"key":"",
"queryType":0,
"status":0,
"pageNum":1,
"pageSize":20
}批量查询示例：
{
"id":"199D9E6F70114AD3A36ACA6A9742B66D",
"keyType":1,
"key":"344050190425,13100000008",
"queryType":0,
"status":0,
"pageNum":1,
"pageSize":20
}2.3.参数说明
| 字段 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| id | String | 公司组织唯一标识 | Y |
| key | String | 模糊查询Key，如果是按终端ID号批量查询则用英文半角逗号隔开 | Y |
| keyType | int | 0:是按模糊查询;1:通过终端ID批量查询 | Y |
| queryType | int | 0:查全部；1:查直属 | 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 | 软件版本 |
4.请求示例
作者：admin 创建时间：2023-04-16 20:05
最后编辑：admin 更新时间：2025-04-23 17:26
最后编辑：admin 更新时间：2025-04-23 17:26
