goodwe-logo开放平台
文档官网

租户名下系统列表查询

接口描述

功能描述

查询用户下系统列表信息，如需获取系统历史测点数据，需用系统id进行。

访问限制

每个ip的限流次数：每分钟10次。

请求方式

HTTPS调用

POST https://we.goodwe.com/api/openapi/v1/service/getTenantSystemList

Header参数

属性类型必填说明
AuthorizationString是用户token

请求参数

属性类型必填说明
isGetFirmwareVersionInteger否是否需要获取设备的固件版本信息（1：需要 0：不需要 （默认不需要））
assetScopeInteger否是否包含分享（0：全部 1租户自身拥有 2：来自其他租户分享 （默认1））

返回参数

属性类型说明示例值
codeString请求成功或失败标识，“00000”请求成功，其余code请求失败-
descriptionString请求结果描述-
dataObject返回数据-
data.dataListList<Object>--
data.dataList[].tenantIdLong租户id1436240154054823938
data.dataList[].idLong系统id1777991922942607360
data.dataList[].nameString系统名称用能系统01
data.dataList[].templateCodeString类型ECSystem
data.dataList[].codeString系统codeaejfoaf
data.dataList[].nodeIdString系统节点id1762388313995608066
data.dataList[].stationIdString所属场站id1742449261636855336
data.dataList[].isSharedBoolean是否来自分享true是false不是
data.dataList[].stateString系统状态normal-正常 abnormal-异常
data.dataList[].stateNameString系统状态normal-正常 abnormal-异常

其他说明

无

调用示例

请求数据示例

json
{
    "isGetFirmwareVersion":0,
    "assetScope":0
}

返回数据示例

样例1：返回用户名下系统列表查询

json
{
  "code": "00000",
  "description": "成功",
  "data": {
    "dataList": [
      {
          "id": "1814212338501419008",
          "name": "光储融合07-25一体机",
          "code": "GCRH-07-25-YTJ-CNXT",
          "templateCode": "Ess_Station",
          "templateType": "PowerStation",
          "tenantId": "1659074779652685824",
          "nodeId": "1814214652876423171",
          "state": "normal",
          "stateName": "正常",
          "isShared": false,
          "stationId": "1814214652373106688"
      },
      {
          "id": "1838751181799817216",
          "name": "用能系统01",
          "code": "YNtest001",
          "templateCode": "ECSystem",
          "templateType": "InteEnergy1",
          "tenantId": "1659074779652685824",
          "state": "abnormal",
          "stateName": "异常",
          "isShared": false
      }
    ]
  }
}
system-list-demo