X-Link API 文档-V4.0.0获取设备信息
获取用户关联的设备列表,分页,支持按终端号查询,该接口只支持管理员用户调用,普通用户用获取用户车辆基本信息获取
请求参数
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
| curPage | integer | 是 | 当前页 |
| pageNum | integer | 是 | 每页数量 |
| userGuid | integer | 否 | 用户ID ,只有登录为超级管理员时,该用户需要查指定的管理用户的信息 |
| deviceNo | string | 否 | 终端号 |
| protocolType | integer | 是 | 协议类型:1:JT2013,2:JT2019 |
| isNotBound | bool | 否 | 未绑定终端 |
响应Data (类型:object)
| 字段 | 类型 | 说明 |
|---|---|---|
| total | integer | 总数量 |
| data | array(object) | 终端列表,查看当前页的表1 |
表1:设备信息
| 字段 | 类型 | 说明 |
|---|---|---|
| deviceNo | string | 终端号 |
| protocolType | integer | 协议类型 1:JT808-2013,2:JT808-2019 |
| channelNum | integer | 通道数量 |
| channelValidFlag | integer | 通道有效标志,按位,比如:3:通道1,2有效 |
| guid | integer | 终端ID |
| adminGuid,omitempty | integer | 管理员ID 管理员为自己的ID |
| createTime | string | 创建时间 |
| updateTime | string | 更新时间 |
示例
请求示例
url
http://localhost:8080/basic_api/v1/device/get_list?curPage=1&pageNum=10&userGuid=1&deviceNo=13000000005&protocolType=1&isNotBound=truehttp://localhost:8080/basic_api/v1/device/get_list?curPage=1&pageNum=10&userGuid=1&deviceNo=13000000005&protocolType=1&isNotBound=true响应示例
json
{
"hdr": {
"code": 200,
"message": "success"
},
"data":
{
"total":1,
"dataList":[{
"devicNo": "13000000005",
"protocolType": 1,
"channelNum": 1,
"channelValidFlag": 1,
"guid": 1,
"adminGuid": 1,
"createTime": "2023-11-04 10:12:50",
"updateTime": "2023-11-04 10:12:50"
}]
}
}{
"hdr": {
"code": 200,
"message": "success"
},
"data":
{
"total":1,
"dataList":[{
"devicNo": "13000000005",
"protocolType": 1,
"channelNum": 1,
"channelValidFlag": 1,
"guid": 1,
"adminGuid": 1,
"createTime": "2023-11-04 10:12:50",
"updateTime": "2023-11-04 10:12:50"
}]
}
}