SolarEdge (獨立發行商) (預覽版)
SolarEdge 連接器可讓您在其他應用中顯示系統資料
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 理查德·維倫加 |
| URL | https://knowledge-center.solaredge.com/ |
| rwconnectors@gmail.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 理查德·維倫加 |
| 網站 | https://www.solaredge.com/ |
| 隱私策略 | https://monitoring.solaredge.com/solaredge-web/p/license |
| 類別 | 物聯網;資料 |
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 密鑰 (api_key) | securestring | 此 API 的api_key | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 儲存資訊 |
從電池中獲取詳細的存儲信息:能量、功率和壽命能量的狀態。 |
| 元件清單 |
傳回特定站台中的逆變器/SMI 清單 |
| 取得儀表資料 |
返回現場每個儀表的使用壽命能量讀數、元數據及其所連接的設備。 |
| 取得感測器清單 |
傳回站台中所有感應器的清單,以及它們所連線的裝置 |
| 現場環境效益 |
根據現場能源生產回報所有環境效益:節省的二氧化碳排放量、種植等效的樹木以及一天的燈泡供電。 |
| 現場能源 |
傳回現場能源測量值 |
| 現場能源 - 詳細 |
從儀表進行詳細的現場能源測量,例如消耗、出口(饋入)、進口(購買)等。 |
| 站台電源流 |
檢索站點所有元素之間的當前功率流,包括光伏陣列、儲能(電池)、負載(消耗)和電網。 |
| 站點能源 – 時間段 |
返回給定時期內產生的站點總能量。 |
| 站點電源 - 詳細 |
從儀表進行詳細的現場功率測量,例如消耗、出口(饋入)、進口(購買)等。 |
| 網站庫存 |
歸還現場 SolarEdge 設備的庫存,包括逆變器/SMI、電池、儀表、網關和傳感器。 |
| 網站概況 |
響應包括現場當前功率、每日能量、每月能量、年度能量和終生能量。 |
| 網站清單 |
傳回與指定權杖相關的網站清單,也就是帳戶api_key。 此 API 接受參數以方便搜尋、排序和分頁。 |
| 網站詳情 |
顯示網站詳細資料,例如名稱、位置、狀態等。 |
| 網站電源 |
以 15 分鐘的解析度傳回站點功率測量值 |
| 設備變更日誌 |
傳回依日期排序的設備元件更換清單。 此方法適用於逆變器、優化器、電池和網關。 |
| 逆變器技術數據 |
傳回給定時間範圍內的特定逆變器資料。 |
儲存資訊
從電池中獲取詳細的存儲信息:能量、功率和壽命能量的狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
網站識別碼
|
startTime | True | string |
網站識別碼 |
|
網站識別碼
|
endTime | True | string |
網站識別碼 |
|
僅傳回特定電池序號的資料
|
serials | string |
僅傳回特定電池序號的數據,清單以逗號分隔。 如果省略,則回應會包含站台中的所有電池 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
電池計數
|
storageData.batteryCount | integer |
回應中包含的電池數量 |
|
電池
|
storageData.batteries | array of object |
電池物件清單 |
|
銘牌
|
storageData.batteries.nameplate | integer |
電池的銘牌(標稱)容量 |
|
serialNumber
|
storageData.batteries.serialNumber | string |
電池序號 |
|
型號
|
storageData.batteries.modelNumber | string |
電池型號 |
|
遙測計數
|
storageData.batteries.telemetryCount | integer |
回應中此電池的遙測數目 |
|
遙測
|
storageData.batteries.telemetries | array of object |
儲存體資料遙測清單 |
|
時間戳記
|
storageData.batteries.telemetries.timeStamp | string |
YYYY-MM-DD HH:MM:SS 格式的遙測時間戳記 |
|
power
|
storageData.batteries.telemetries.power | integer |
正電源表示電池正在充電,負電源表示正在放電 |
|
電池狀態
|
storageData.batteries.telemetries.batteryState | integer |
可以是以下 0(無效)、1(待機)、2(熱管理)、3(啟用)、4(故障)之一 |
|
lifeTimeEnergy充電
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
電池在電池使用壽命期間從電池充電的能量(以 Wh 為單位) |
|
lifeTime能量放電
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
電池在電池使用壽命期間從電池放電的能量(以 Wh 為單位) |
|
fullPackEnergy可用
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
電池目前可儲存的最大能量 (Wh) |
|
內部溫度
|
storageData.batteries.telemetries.internalTemp | integer |
電池內部溫度(攝氏度) |
|
ACGrid充電
|
storageData.batteries.telemetries.ACGridCharging | integer |
在指定日期範圍內從電網為電池充電所使用的交流電量 (以 Wh 為單位) |
|
充電狀態
|
storageData.batteries.telemetries.stateOfCharge | integer |
電池充電狀態佔可用容量的百分比。 值介於 0 到 100 之間 |
元件清單
傳回特定站台中的逆變器/SMI 清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
count
|
reporters.count | integer |
網站元件計數 |
|
list
|
reporters.list | array of object |
list |
|
元件名稱
|
reporters.list.componentname | string |
元件名稱 |
|
製造商
|
reporters.list.manufacturer | string |
組件製造商 |
|
型號
|
reporters.list.Model | string |
元件模型 |
|
SerialNumber
|
reporters.list.SerialNumber | string |
元件 serialNumber |
取得儀表資料
返回現場每個儀表的使用壽命能量讀數、元數據及其所連接的設備。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
彙總精細度
|
timeUnit | string |
彙總精細度,允許的值為 QUARTER_OF_AN_HOUR、HOUR、DAY、WEEK、MONTH、YEAR |
|
|
能量測量的開始時間為 yyyy-MM-DD hh:mm:ss 格式
|
startTime | True | string |
能量測量的開始時間為 yyyy-MM-DD hh:mm:ss 格式 |
|
測量的能量結束時間以 yyyy-MM-DD hh:mm:ss 格式
|
endTime | True | string |
測量的能量結束時間以 yyyy-MM-DD hh:mm:ss 格式 |
|
僅選擇特定儀表
|
meters | string |
僅選擇特定儀表。 如果省略此值,則會傳回所有計量讀數。 允許的值為 Production、Consumption、FeedIn、Purchased |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時間單位
|
meterEnergyDetails.timeUnit | string |
彙總精細度 |
|
單位
|
meterEnergyDetails.unit | string |
退回的儀表單位 (Wh) |
|
米
|
meterEnergyDetails.meters | array of object |
每米值 |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
已連接SolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
儀表所連接的逆變器 |
|
型號
|
meterEnergyDetails.meters.model | string |
儀表型號 |
|
米類型
|
meterEnergyDetails.meters.meterType | string |
儀表類型 生產、消費、饋入或採購 |
|
values
|
meterEnergyDetails.meters.values | array of object |
每個日期的每米值 |
|
date
|
meterEnergyDetails.meters.values.date | string |
測量時間戳記 |
|
value
|
meterEnergyDetails.meters.values.value | float |
終身能量讀數 |
取得感測器清單
傳回站台中所有感應器的清單,以及它們所連線的裝置
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
站點感應器計數 |
|
list
|
SiteSensors.list | array of object |
每個閘道的清單 |
|
連線至
|
SiteSensors.list.connectedTo | string |
感測器所連接的閘道名稱 |
|
count
|
SiteSensors.list.count | integer |
閘道感測器計數 |
|
sensors
|
SiteSensors.list.sensors | array of object |
sensors |
|
名稱
|
SiteSensors.list.sensors.name | string |
感應器名稱 |
|
尺寸
|
SiteSensors.list.sensors.measurement | string |
感測器測量的內容,例如 SensorGlobalHorizontalIrradiance、SensorDiffusedIrradiance、SensorAmbientTemperature |
|
型別
|
SiteSensors.list.sensors.type | string |
感測器測量的內容,例如 SensorGlobalHorizontalIrradiance、SensorDiffusedIrradiance、SensorAmbientTemperature |
現場環境效益
根據現場能源生產回報所有環境效益:節省的二氧化碳排放量、種植等效的樹木以及一天的燈泡供電。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
單位
|
envBenefits.gasEmissionSaved.units | string |
其餘結果的單位 |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
二氧化碳 (公斤或磅) |
|
SO2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 (公斤或磅) |
|
氮氧化物
|
envBenefits.gasEmissionSaved.nox | float |
氮氧化物(公斤或磅) |
|
樹木種植
|
envBenefits.treesPlanted | float |
等效種植新樹以降低二氧化碳水平 |
|
燈泡
|
envBenefits.lightBulbs | float |
一天內可由該站點供電的燈泡數量 |
現場能源
傳回現場能源測量值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
彙總精細度
|
timeUnit | True | string |
彙總精細度,允許的值為 QUARTER_OF_AN_HOUR、HOUR、DAY、WEEK、MONTH、YEAR |
|
傳回能源測量的開始日期
|
startDate | True | string |
傳回能源測量的開始日期 |
|
結束日期返回能源測量
|
endDate | True | string |
結束日期返回能源測量 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時間單位
|
energy.timeUnit | string |
請求的時間單位 |
|
單位
|
energy.unit | string |
測量單位 |
|
測量者
|
energy.measuredBy | string |
測量來源 |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
日期時間 |
|
value
|
energy.values.value | float |
在指定日期時間測得的功率(即瓦特) |
現場能源 - 詳細
從儀表進行詳細的現場能源測量,例如消耗、出口(饋入)、進口(購買)等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
彙總精細度
|
timeUnit | True | string |
彙總精細度,允許的值為 QUARTER_OF_AN_HOUR、HOUR、DAY、WEEK、MONTH、YEAR |
|
能量測量的開始時間為 yyyy-MM-DD hh:mm:ss 格式
|
startTime | True | string |
能量測量的開始時間為 yyyy-MM-DD hh:mm:ss 格式 |
|
測量的能量結束時間以 yyyy-MM-DD hh:mm:ss 格式
|
endTime | True | string |
測量的能量結束時間以 yyyy-MM-DD hh:mm:ss 格式 |
|
僅選擇特定儀表
|
Meters | True | string |
僅選擇特定儀表,如果空白,則返回所有內容。 允許的值為 PRODUCTION、CONSUMPTION、SelfConsumption、FeedIn、Purchased |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時間單位
|
energyDetails.timeUnit | string |
請求的時間單位 |
|
單位
|
energyDetails.unit | string |
測量單位 |
|
米
|
energyDetails.meters | array of object |
米 |
|
型別
|
energyDetails.meters.type | string |
型別 |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
日期時間 |
|
value
|
energyDetails.meters.values.value | float |
在指定日期時間測得的功率(即瓦特) |
站台電源流
檢索站點所有元素之間的當前功率流,包括光伏陣列、儲能(電池)、負載(消耗)和電網。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
單位
|
siteCurrentPowerFlow.unit | string |
測量單位(例如瓦特) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
包含元素之間所有關係的表格,以及動力流方向 (產生元素和消耗元素) |
|
從
|
siteCurrentPowerFlow.connections.from | string |
提供動力的元件 |
|
至
|
siteCurrentPowerFlow.connections.to | string |
消耗電力的元素 |
|
狀態
|
siteCurrentPowerFlow.GRID.status | string |
網格狀態(作用中/閒置/停用) |
|
電流功率
|
siteCurrentPowerFlow.GRID.currentPower | float |
當前電網電力 |
|
狀態
|
siteCurrentPowerFlow.LOAD.status | string |
負載狀態(活動/空閒/禁用) |
|
電流功率
|
siteCurrentPowerFlow.LOAD.currentPower | float |
當前負載功率 |
|
狀態
|
siteCurrentPowerFlow.PV.status | string |
PV 狀態(活動/閒置/禁用) |
|
電流功率
|
siteCurrentPowerFlow.PV.currentPower | float |
當前光伏發電 |
|
狀態
|
siteCurrentPowerFlow.STORAGE.status | string |
儲存狀態(作用中/閒置/停用) |
|
電流功率
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
電流儲存功率 |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
儲存空間收費層級 |
|
危急
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
儲存至關重要? |
|
時間左
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
在備份模式下,儲存空間用完前的指定時間 |
站點能源 – 時間段
返回給定時期內產生的站點總能量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
傳回能源測量的開始日期
|
startDate | True | string |
傳回能源測量的開始日期 |
|
結束日期返回能源測量
|
endDate | True | string |
結束日期返回能源測量 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
能源
|
timeFrameEnergy.energy | float |
能源摘要 |
|
單位
|
timeFrameEnergy.unit | string |
能量單位 (Wh) |
|
測量者
|
timeFrameEnergy.measuredBy | string |
測量的來源 |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
提供的開始日期資訊 |
|
能源
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
開始日期能量 |
|
單位
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
開始日期單位 (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
提供的結束日期資訊 |
|
能源
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
結束日期能量 |
|
單位
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
結束日期單位 (Wh) |
站點電源 - 詳細
從儀表進行詳細的現場功率測量,例如消耗、出口(饋入)、進口(購買)等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
能量測量開始時間
|
startTime | True | string |
能量測量的開始時間為 yyyy-MM-DD hh:mm:ss 格式 |
|
測量的能量結束時間
|
endTime | True | string |
測量的能量結束時間以 yyyy-MM-DD hh:mm:ss 格式 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時間單位
|
powerDetails.timeUnit | string |
請求的時間單位 |
|
單位
|
powerDetails.unit | string |
測量單位 |
|
米
|
powerDetails.meters | array of object |
計量 |
|
型別
|
powerDetails.meters.type | string |
儀表類型(生產/消費/自用/饋入(出口)/採購(進口)) |
|
values
|
powerDetails.meters.values | array of object |
每個日期的日期和電源對 |
|
date
|
powerDetails.meters.values.date | string |
日期時間 |
|
value
|
powerDetails.meters.values.value | float |
指定日期時間的電源 |
網站庫存
歸還現場 SolarEdge 設備的庫存,包括逆變器/SMI、電池、儀表、網關和傳感器。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
米
|
Inventory.meters | array of object |
指定站點的儀表列表 |
|
名稱
|
Inventory.meters.name | string |
儀表名稱 |
|
製造商
|
Inventory.meters.manufacturer | string |
儀表製造商 |
|
型號
|
Inventory.meters.model | string |
儀表型號 |
|
韌體版本
|
Inventory.meters.firmwareVersion | string |
儀表韌體版本 |
|
已連接SolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– 儀表所連接的 SolarEdge 設備的名稱 |
|
型別
|
Inventory.meters.type | string |
儀表類型,例如“生產” |
|
表單
|
Inventory.meters.form | string |
硬體儀表的實體或虛擬的,如果透過其他儀表之間的算術計算 |
|
sensors
|
Inventory.sensors | array of object |
指定站點的傳感器列表 |
|
已連接SolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– 傳感器所連接的 SolarEdge 設備的名稱 |
|
識別碼
|
Inventory.sensors.id | string |
感應器識別碼 |
|
連線至
|
Inventory.sensors.connectedTo | string |
它所連接的裝置名稱,例如「閘道 1」 |
|
分類
|
Inventory.sensors.category | string |
感測器類別,例如輻照度 |
|
型別
|
Inventory.sensors.type | string |
感測器類型,例如「陣列輻照度平面」 |
|
gateways
|
Inventory.gateways | array of object |
指定站台的閘道清單 |
|
名稱
|
Inventory.gateways.name | string |
逆變器名稱,例如逆變器 1 |
|
韌體版本
|
Inventory.gateways.firmwareVersion | string |
設備韌體版本 |
|
序列號 (if "SN" stands for serial number)
|
Inventory.gateways.SN | string |
設備序號,例如 7F123456-00 |
|
電池
|
Inventory.batteries | array of object |
指定地點的電池清單 |
|
名稱
|
Inventory.batteries.name | string |
電池名稱 |
|
製造商
|
Inventory.batteries.manufacturer | string |
電池製造商 |
|
型號
|
Inventory.batteries.model | string |
電池型號 |
|
韌體版本
|
Inventory.batteries.firmwareVersion | string |
電池韌體版本 |
|
已連接逆變器Sn
|
Inventory.batteries.connectedInverterSn | string |
– 電池所連接的逆變器/網關的序列號 |
|
銘牌容量
|
Inventory.batteries.nameplateCapacity | integer |
製造商提供的電池銘牌容量 |
|
序列號 (if "SN" stands for serial number)
|
Inventory.batteries.SN | string |
電池序號 |
|
逆變器
|
Inventory.inverters | array of object |
指定站點逆變器列表 |
|
名稱
|
Inventory.inverters.name | string |
逆變器名稱 |
|
製造商
|
Inventory.inverters.manufacturer | string |
逆變器製造商 |
|
型號
|
Inventory.inverters.model | string |
逆變器型號 |
|
韌體版本
|
Inventory.inverters.firmwareVersion | string |
逆變器韌體版本 |
|
序列號 (if "SN" stands for serial number)
|
Inventory.inverters.SN | string |
逆變器序列號 |
|
connectedOptimizer
|
Inventory.inverters.connectedOptimizers | integer |
連接到逆變器的優化器數量 |
網站概況
響應包括現場當前功率、每日能量、每月能量、年度能量和終生能量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
最後更新時間
|
overview.lastUpdateTime | string |
最後更新時間 |
|
能源
|
overview.lifeTimeData.energy | float |
終生能量數 |
|
能源
|
overview.lastYearData.energy | float |
去年的能源數字 |
|
能源
|
overview.lastMonthData.energy | float |
能量數 |
|
能源
|
overview.lastDayData.energy | float |
最後一天的能量數字 |
|
power
|
overview.currentPower.power | float |
目前電源號碼 |
|
測量者
|
overview.measuredBy | string |
測量單位 |
網站清單
傳回與指定權杖相關的網站清單,也就是帳戶api_key。 此 API 接受參數以方便搜尋、排序和分頁。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
count
|
sites.count | integer |
傳回的網站數量。 |
|
網站
|
sites.site | array of object |
網站 |
|
網站標識碼
|
sites.site.id | integer |
網站識別碼。 |
|
名稱
|
sites.site.name | string |
網站名稱 |
|
accountId
|
sites.site.accountId | integer |
本站所屬的帳號 |
|
狀態
|
sites.site.status | string |
網站狀態 |
|
峰值功率
|
sites.site.peakPower | float |
站點峰值功率 |
|
最後更新時間
|
sites.site.lastUpdateTime | string |
網站最後更新日期時間,格式為 yyyy-mm-dd hh:mm:ss |
|
安裝日期
|
sites.site.installationDate | string |
網站安裝日期時間,格式 yyyy-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
許可經營日期 |
|
附註
|
sites.site.notes | string |
註釋 |
|
型別
|
sites.site.type | string |
網站類型 |
|
country
|
sites.site.location.country | string |
網站國家 |
|
city
|
sites.site.location.city | string |
網站 城市 |
|
address
|
sites.site.location.address | string |
這些網站地址 |
|
位址2
|
sites.site.location.address2 | string |
網站地址2 |
|
壓縮檔
|
sites.site.location.zip | string |
網站 zip |
|
timeZone
|
sites.site.location.timeZone | string |
網站 timeZone |
|
countryCode (國家代碼)
|
sites.site.location.countryCode | string |
網站國家代碼 |
|
製造商名稱
|
sites.site.primaryModule.manufacturerName | string |
主要型號製造商名稱 |
|
modelName
|
sites.site.primaryModule.modelName | string |
主要模型 modelName |
|
最大功率
|
sites.site.primaryModule.maximumPower | float |
主要型號 maximumPower |
|
溫度係數
|
sites.site.primaryModule.temperatureCoef | float |
主要型號溫度係數 |
網站詳情
顯示網站詳細資料,例如名稱、位置、狀態等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
details.id | integer |
網站 ID |
|
名稱
|
details.name | string |
網站名稱 |
|
accountId
|
details.accountId | integer |
本站所屬的帳號 |
|
狀態
|
details.status | string |
網站狀態 |
|
峰值功率
|
details.peakPower | float |
網站 peakPower |
|
貨幣
|
details.currency | string |
網站貨幣 |
|
安裝日期
|
details.installationDate | string |
網站安裝日期時間,格式 yyyy-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
許可經營日期 |
|
附註
|
details.notes | string |
註釋 |
|
型別
|
details.type | string |
網站類型 |
|
country
|
details.location.country | string |
網站國家 |
|
city
|
details.location.city | string |
網站 城市 |
|
address
|
details.location.address | string |
這些網站地址 |
|
位址2
|
details.location.address2 | string |
網站地址2 |
|
壓縮檔
|
details.location.zip | string |
網站 zip |
|
timeZone
|
details.location.timeZone | string |
網站 timeZone |
|
countryCode (國家代碼)
|
details.location.countryCode | string |
網站國家代碼 |
|
alertQuantity
|
details.alertQuantity | integer |
此網站中開啟的警示數目 |
|
alert嚴重性
|
details.alertSeverity | string |
此網站中最高的警示嚴重性 |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
網站影像 uri |
網站電源
以 15 分鐘的解析度傳回站點功率測量值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
開始日期和時間
|
startTime | True | string |
取得功率測量的開始日期和時間 (yyyy-mm-dd hh:mm:ss) |
|
開始日期和時間
|
endTime | True | string |
取得功率測量的開始日期和時間 (yyyy-mm-dd hh:mm:ss) |
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時間單位
|
power.timeUnit | string |
時間單位(即QUARTER_OF_AN_HOUR) |
|
單位
|
power.unit | string |
測量單位(即瓦特) |
|
測量者
|
power.measuredBy | string |
測量來源 |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
日期時間 |
|
value
|
power.values.value | float |
在指定日期時間測得的功率(即瓦特) |
設備變更日誌
傳回依日期排序的設備元件更換清單。 此方法適用於逆變器、優化器、電池和網關。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
設備的序號
|
equipment_id | True | string |
設備的序號 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
設備短序號 |
|
零件號碼
|
ChangeLog.list.partNumber | string |
逆變器/電池/優化器/網關型號 |
|
date
|
ChangeLog.list.date | string |
更換該設備組件的日期 |
逆變器技術數據
傳回給定時間範圍內的特定逆變器資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站識別碼
|
site_id | True | integer |
網站識別碼 |
|
設備的序號
|
equipment_id | True | string |
設備的序號 |
|
獲取逆變器數據的開始(日期+時間)
|
startTime | True | string |
獲取逆變器數據的開始(日期+時間) |
|
獲取逆變器數據的結束(日期+時間)
|
endTime | True | string |
獲取逆變器數據的結束(日期+時間) |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
count
|
data.count | integer |
回應計數 |
|
遙測
|
data.telemetries | array of object |
遙測 |
|
三相逆變器遙測
|
data.telemetries.threePhaseInverterTelemetry | array of object |
三相逆變器遙測 |
|
date
|
data.telemetries.threePhaseInverterTelemetry.date | string |
date |
|
總主動功率
|
data.telemetries.threePhaseInverterTelemetry.totalActivePower | string |
總主動功率 |
|
直流電壓
|
data.telemetries.threePhaseInverterTelemetry.dcVoltage | float |
直流電壓 |
|
接地故障抵抗
|
data.telemetries.threePhaseInverterTelemetry.groundFaultResistance | float |
接地故障抵抗 |
|
powerLimit
|
data.telemetries.threePhaseInverterTelemetry.powerLimit | float |
powerLimit |
|
總能量
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
總能量 |
|
溫度
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
溫度(攝氏度) |
|
逆變器模式
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
逆變器的狀態,即關閉、啟動、MPPT 等。 |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
運行模式整數 0 併網,1 在光伏或電池的離網模式下運行,2 在發電機的離網模式下運行 |
|
交流電流
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acCurrent | float |
交流電流 |
|
交流電壓
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acVoltage | float |
交流電壓 |
|
ac頻率
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acFrequency | float |
ac頻率 |
|
視在功率
|
data.telemetries.threePhaseInverterTelemetry.L1Data.apparentPower | integer |
視在功率 |
|
主動電源
|
data.telemetries.threePhaseInverterTelemetry.L1Data.activePower | integer |
主動電源 |
|
無功功率
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
無功功率 |
|
科斯菲
|
data.telemetries.threePhaseInverterTelemetry.L1Data.cosPhi | integer |
科斯菲 |
|
vL1To2
|
data.telemetries.threePhaseInverterTelemetry.vL1To2 | float |
vL1To2 |
|
vL2To3
|
data.telemetries.threePhaseInverterTelemetry.vL2To3 | float |
vL2To3 |
|
vL3To1
|
data.telemetries.threePhaseInverterTelemetry.vL3To1 | float |
vL3To1 |
|
交流電流
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acCurrent | float |
交流電流 |
|
交流電壓
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acVoltage | float |
交流電壓 |
|
ac頻率
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acFrequency | float |
ac頻率 |
|
視在功率
|
data.telemetries.threePhaseInverterTelemetry.L2Data.apparentPower | integer |
視在功率 |
|
主動電源
|
data.telemetries.threePhaseInverterTelemetry.L2Data.activePower | integer |
主動電源 |
|
無功功率
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
無功功率 |
|
科斯菲
|
data.telemetries.threePhaseInverterTelemetry.L2Data.cosPhi | integer |
科斯菲 |
|
交流電流
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acCurrent | float |
交流電流 |
|
交流電壓
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acVoltage | float |
交流電壓 |
|
ac頻率
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acFrequency | float |
ac頻率 |
|
視在功率
|
data.telemetries.threePhaseInverterTelemetry.L3Data.apparentPower | integer |
視在功率 |
|
主動電源
|
data.telemetries.threePhaseInverterTelemetry.L3Data.activePower | integer |
主動電源 |
|
無功功率
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
無功功率 |
|
科斯菲
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
科斯菲 |