设备管理
概述
设备管理接口用于设备的注册、查询、删除等操作。
设备注册
接口信息
| 项目 | 说明 |
|---|---|
| 接口地址 | http://iot.datacom.vip:11111/Device_Register |
| 请求方式 | POST |
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Authorization | Bearer <your_token> |
Body (raw JSON)
{
"BuildID": "1234567890",
"Code": "DEVICE001",
"Name": "1 号电表",
"Type": 1
}
请求参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| BuildID | string | 是 | 建筑 ID |
| Code | string | 是 | 设备编码（唯一标识） |
| Name | string | 是 | 设备名称 |
| Type | number | 是 | 数据类型（1=总表用电，2=燃气表，3=照明插座用电，4=暖通空调用电，5=动力设备用电，6=特殊用电，7=其他用电，8=可再生能源用电，9=电力局总表用电） |
响应示例
{
"Code": 200,
"Type": "Success",
"MeterID": "MTR123456",
"Message": "DEVICE001 Registered!",
"TokenEXP": 7100,
"RequestID": "a1b2c3d4e5f6"
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| Code | number | 响应码 |
| Type | string | 响应类型 |
| MeterID | string | 平台分配的仪表 ID |
| Message | string | 响应消息 |
| TokenEXP | number | Token 剩余有效期（秒） |
| RequestID | string | 请求唯一标识 |
错误码
| 错误码 | 说明 |
|---|---|
| 30001 | Token 验证失败 |
| 40001 | 设备注册失败 |
| 41002 | BuildID 不存在 |
| 50001 | 服务器内部错误 |
获取设备信息
接口信息
| 项目 | 说明 |
|---|---|
| 接口地址 | http://iot.datacom.vip:11111/Get_MeterInfo |
| 请求方式 | POST |
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Authorization | Bearer <your_token> |
Body (raw JSON)
{
"BuildID": "1234567890",
"GateWayID": "GW001"
}
请求参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| BuildID | string | 是 | 建筑 ID |
| GateWayID | string | 是 | 网关 ID |
响应示例
{
"Code": 200,
"Type": "Success",
"TokenEXP": 7100,
"Data": [
{
"Code": "DEVICE001",
"MeterID": "MTR123456",
"Name": "1 号电表",
"Type": 1,
"isOnline": 1,
"Model": "MBGW-100",
"GateWayID": "GW001",
"BusNO": 1,
"RtuNO": 1
}
],
"RequestID": "a1b2c3d4e5f6"
}
数据字段
| 字段 | 类型 | 说明 |
|---|---|---|
| Code | string | 设备编码 |
| MeterID | string | 仪表 ID |
| Name | string | 设备名称 |
| Type | number | 设备类型 |
| isOnline | number | 在线状态（1=在线，0=离线） |
| Model | string | 设备型号 |
| GateWayID | string | 所属网关 ID |
| BusNO | number | 总线号 |
| RtuNO | number | RTU 号 |
错误码
| 错误码 | 说明 |
|---|---|
| 30001 | Token 验证失败 |
| 41002 | BuildID 不存在 |
| 41004 | 未找到指定网关的设备 |
设备删除
接口信息
| 项目 | 说明 |
|---|---|
| 接口地址 | http://iot.datacom.vip:11111/Device_Delete |
| 请求方式 | POST |
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Authorization | Bearer <your_token> |
Body (raw JSON)
{
"MeterID": "MTR123456"
}
请求参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| MeterID | string | 是 | 仪表 ID |
响应示例
{
"Code": 200,
"Type": "Success",
"TokenEXP": 7100,
"Message": "MTR123456 Deleted!",
"RequestID": "a1b2c3d4e5f6"
}
错误码
| 错误码 | 说明 |
|---|---|
| 30001 | Token 验证失败 |
| 40003 | 设备不存在 |
| 50001 | 服务器内部错误 |