查询账号激活场站的设备信息。
接口说明
通过采集终端设备 id，查询设备参数，如果是通过校验，可以查询接口信息，如果不是，返回空值。
需要按天维度的时间，及对单个设备进行查询。如果数据不存在，则返回空值。
目前接入点仅支持杭州
energyexpertexternal.cn-hangzhou.aliyuncs.com使用该接口需要先开通白名单，请通过官网联系我们 进行开通。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
energy:GetDeviceInfo |
list |
*全部资源
|
无 | 无 |
请求语法
GET /api/external/getDeviceInfo HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| factoryId |
string |
是 |
场站 id |
pn_95 |
| deviceId |
string |
是 |
设备 id |
pn_69873 |
| ds |
string |
是 |
时间字符串，时间格式为 YYYY-mm-dd |
2022-07-26 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求 ID |
83A5A7DD-8974-5769-952E-590A97BEA34E |
| httpCode |
integer |
http 状态码 |
200 |
| code |
string |
请求返回 code，Success 代表请求成功，其他情况代表请求不成功，具体错误原因描述可通过 msg 查看。 |
Success |
| success |
boolean |
请求是否成功 |
true |
| data |
object |
返回信息 |
|
| deviceId |
string |
设备 id |
pn_69873 |
| deviceName |
string |
设备名称 |
主变4# |
| firstTypeName |
string |
表计一级类型 |
电表 |
| secondTypeName |
string |
表计二级类型 |
关口表 |
| recordList |
array<object> |
参数列表 |
|
|
object |
设备信息 |
||
| statisticsDate |
string |
统计日期 |
2022-07-26 00:00:00 |
| paramName |
string |
参数名称 |
A相电流 |
| unit |
string |
单位 |
A |
| identifier |
string |
设备标识符 |
Ia |
| type |
string |
测点类型 |
DOUBLE |
| value |
number |
数值 |
20.00 |
示例
正常返回示例
JSON格式
{
"requestId": "83A5A7DD-8974-5769-952E-590A97BEA34E",
"httpCode": 200,
"code": "Success",
"success": true,
"data": {
"deviceId": "pn_69873",
"deviceName": "主变4#",
"firstTypeName": "电表",
"secondTypeName": "关口表",
"recordList": [
{
"statisticsDate": "2022-07-26 00:00:00",
"paramName": "A相电流",
"unit": "A",
"identifier": "Ia",
"type": "DOUBLE",
"value": 20
}
]
}
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | invalidParameter | Invalid parameter values. | 请求参数错误，请检查方法入参 |
| 401 | notAuthorized | No permissions to call API operations. | 该账号没有API调用权限 |
| 500 | systemError | System error. | 系统错误 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。