SolarEdge(독립 게시자)(미리 보기)
SolarEdge 커넥터는 다른 애플리케이션에서 시스템 데이터를 표시할 수 있는 oppurtunity를 제공합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 리처드 위렌가 |
| URL | https://knowledge-center.solaredge.com/ |
| 전자 메일 | rwconnectors@gmail.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 리처드 위렌가 |
| 웹 사이트 | https://www.solaredge.com/ |
| 개인 정보 보호 정책 | https://monitoring.solaredge.com/solaredge-web/p/license |
| 카테고리 | 사물 인터넷; 데이터 |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 api에 대한 api_key | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 구성 요소 목록 |
특정 사이트에서 인버터/SPI 목록을 반환합니다. |
| 미터 데이터 가져오기 |
현장의 각 미터의 수명 에너지 판독, 메타데이터 및 연결된 디바이스를 반환합니다. |
| 사이트 개요 |
응답에는 현장 현재 전력, 일일 에너지, 월별 에너지, 연간 에너지 및 수명 시간 에너지가 포함됩니다. |
| 사이트 목록 |
api_key 계정인 지정된 토큰과 관련된 사이트 목록을 반환합니다. 이 API는 편리한 검색, 정렬 및 페이지 매김을 위한 매개 변수를 허용합니다. |
| 사이트 세부 정보 |
이름, 위치, 상태 등과 같은 사이트 세부 정보를 표시합니다. |
| 사이트 에너지 |
사이트 에너지 측정값 반환 |
| 사이트 에너지 - 자세한 정보 |
소비, 내보내기(피드인), 가져오기(구매) 등과 같은 미터의 자세한 사이트 에너지 측정 |
| 사이트 에너지 – 기간 |
지정된 기간 동안 생산된 사이트 총 에너지를 반환합니다. |
| 사이트 인벤토리 |
인버터/SPI, 배터리, 미터, 게이트웨이 및 센서를 포함하여 현장에서 SolarEdge 장비의 인벤토리를 반환합니다. |
| 사이트 전원 |
15분 해상도로 사이트 전원 측정값 반환 |
| 사이트 전원 - 자세한 정보 |
소비, 내보내기(피드인), 가져오기(구매) 등 미터의 자세한 사이트 전력 측정 |
| 사이트 전원 흐름 |
PV 배열, 스토리지(배터리), 로드(사용량) 및 그리드를 포함하여 사이트의 모든 요소 간에 현재 전원 흐름을 검색합니다. |
| 사이트 환경 혜택 |
사이트 에너지 생산에 따른 모든 환경적 이점을 반환합니다. CO2 배출을 절약하고, 동급의 나무를 심고, 하루 동안 전력을 공급합니다. |
| 센서 목록 가져오기 |
사이트의 모든 센서 및 센서가 연결된 디바이스의 목록을 반환합니다. |
| 스토리지 정보 |
배터리에서 에너지, 전력 및 수명 에너지의 상태에 대한 자세한 저장 정보를 가져옵니다. |
| 인버터 기술 데이터 |
지정된 기간에 대한 특정 인버터 데이터를 반환합니다. |
| 장비 변경 로그 |
날짜별로 정렬된 장비 구성 요소 교체 목록을 반환합니다. 이 방법은 인버터, 최적화 프로그램, 배터리 및 게이트웨이에 적용할 수 있습니다. |
구성 요소 목록
특정 사이트에서 인버터/SPI 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
count
|
reporters.count | integer |
사이트 구성 요소 수 |
|
list
|
reporters.list | array of object |
list |
|
componentname
|
reporters.list.componentname | string |
구성 요소 이름 |
|
manufacturer
|
reporters.list.manufacturer | string |
구성 요소 제조업체 |
|
Model
|
reporters.list.Model | string |
구성 요소 모델 |
|
시리얼 번호
|
reporters.list.SerialNumber | string |
구성 요소 serialNumber |
미터 데이터 가져오기
현장의 각 미터의 수명 에너지 판독, 메타데이터 및 연결된 디바이스를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | 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입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
집계 세분성 |
|
단위
|
meterEnergyDetails.unit | string |
반환된 미터 단위(Wh) |
|
미터
|
meterEnergyDetails.meters | array of object |
미터당 값 |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
미터가 연결된 인버터 |
|
model
|
meterEnergyDetails.meters.model | string |
미터 모델 |
|
미터 유형
|
meterEnergyDetails.meters.meterType | string |
미터 유형 프로덕션, 소비량, FeedIn 또는 구매 |
|
values
|
meterEnergyDetails.meters.values | array of object |
날짜당 미터당 값 |
|
date
|
meterEnergyDetails.meters.values.date | string |
측정 타임스탬프 |
|
value
|
meterEnergyDetails.meters.values.value | float |
수명 에너지 읽기 |
사이트 개요
응답에는 현장 현재 전력, 일일 에너지, 월별 에너지, 연간 에너지 및 수명 시간 에너지가 포함됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
lastUpdateTime
|
overview.lastUpdateTime | string |
lastUpdateTime |
|
energy
|
overview.lifeTimeData.energy | float |
수명 에너지 번호 |
|
energy
|
overview.lastYearData.energy | float |
작년 에너지 번호 |
|
energy
|
overview.lastMonthData.energy | float |
에너지 번호 |
|
energy
|
overview.lastDayData.energy | float |
마지막 날 에너지 번호 |
|
power
|
overview.currentPower.power | float |
현재 전원 번호 |
|
measuredBy
|
overview.measuredBy | string |
측정 기준 |
사이트 목록
api_key 계정인 지정된 토큰과 관련된 사이트 목록을 반환합니다. 이 API는 편리한 검색, 정렬 및 페이지 매김을 위한 매개 변수를 허용합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
count
|
sites.count | integer |
반환되는 사이트의 양입니다. |
|
웹사이트
|
sites.site | array of object |
웹사이트 |
|
SiteID
|
sites.site.id | integer |
사이트 ID입니다. |
|
이름
|
sites.site.name | string |
사이트 이름 |
|
accountId
|
sites.site.accountId | integer |
이 사이트가 속한 계정 |
|
status
|
sites.site.status | string |
사이트 상태 |
|
peakPower
|
sites.site.peakPower | float |
사이트 최대 전력 |
|
lastUpdateTime
|
sites.site.lastUpdateTime | string |
Site last update datetime, format yyyy-mm-dd hh:mm:ss |
|
installationDate
|
sites.site.installationDate | string |
사이트 설치 날짜/시간, 형식 yyyy-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
작업 날짜에 대한 권한 |
|
메모
|
sites.site.notes | string |
비고 |
|
type
|
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 |
|
국가 코드
|
sites.site.location.countryCode | string |
사이트 국가 코드 |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
기본 모델 manufacturerName |
|
modelName
|
sites.site.primaryModule.modelName | string |
기본 모델 modelName |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
기본 모델 maximumPower |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
기본 모델 temperatureCoef |
사이트 세부 정보
이름, 위치, 상태 등과 같은 사이트 세부 정보를 표시합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
details.id | integer |
사이트 ID |
|
이름
|
details.name | string |
사이트 이름 |
|
accountId
|
details.accountId | integer |
이 사이트가 속한 계정 |
|
status
|
details.status | string |
사이트 상태 |
|
peakPower
|
details.peakPower | float |
사이트 피크 파워 |
|
currency
|
details.currency | string |
사이트 통화 |
|
installationDate
|
details.installationDate | string |
사이트 설치 날짜/시간, 형식 yyyy-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
작업 날짜에 대한 권한 |
|
메모
|
details.notes | string |
비고 |
|
type
|
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 |
|
국가 코드
|
details.location.countryCode | string |
사이트 국가 코드 |
|
alertQuantity
|
details.alertQuantity | integer |
이 사이트의 열린 경고 수 |
|
alertSeverity
|
details.alertSeverity | string |
이 사이트에서 가장 높은 경고 심각도 |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
사이트 이미지 URI |
사이트 에너지
사이트 에너지 측정값 반환
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
|
집계 세분성
|
timeUnit | True | string |
집계 세분성, 허용되는 값은 QUARTER_OF_AN_HOUR, HOUR, DAY, WEEK, MONTH, YEAR입니다. |
|
에너지 측정을 반환하는 시작 날짜
|
startDate | True | string |
에너지 측정을 반환하는 시작 날짜 |
|
종료 날짜 반환 에너지 측정
|
endDate | True | string |
종료 날짜 반환 에너지 측정 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
요청된 시간 단위 |
|
단위
|
energy.unit | string |
측정 단위 |
|
measuredBy
|
energy.measuredBy | string |
측정 원본 |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
날짜와 시간 |
|
value
|
energy.values.value | float |
지정된 날짜/시간에 측정된 전력(예: 와트) |
사이트 에너지 - 자세한 정보
소비, 내보내기(피드인), 가져오기(구매) 등과 같은 미터의 자세한 사이트 에너지 측정
매개 변수
| Name | 키 | 필수 | 형식 | 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입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
요청된 시간 단위 |
|
단위
|
energyDetails.unit | string |
측정 단위 |
|
미터
|
energyDetails.meters | array of object |
미터 |
|
type
|
energyDetails.meters.type | string |
type |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
날짜와 시간 |
|
value
|
energyDetails.meters.values.value | float |
지정된 날짜/시간에 측정된 전력(예: 와트) |
사이트 에너지 – 기간
지정된 기간 동안 생산된 사이트 총 에너지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
|
에너지 측정을 반환하는 시작 날짜
|
startDate | True | string |
에너지 측정을 반환하는 시작 날짜 |
|
종료 날짜 반환 에너지 측정
|
endDate | True | string |
종료 날짜 반환 에너지 측정 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
energy
|
timeFrameEnergy.energy | float |
에너지 요약 |
|
단위
|
timeFrameEnergy.unit | string |
에너지 단위(Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
측정의 원본 |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
제공된 시작 날짜 정보 |
|
energy
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
시작 날짜 에너지 |
|
단위
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
시작 날짜 단위(Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
제공된 종료 날짜 정보 |
|
energy
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
종료 날짜 에너지 |
|
단위
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
종료 날짜 단위(Wh) |
사이트 인벤토리
인버터/SPI, 배터리, 미터, 게이트웨이 및 센서를 포함하여 현장에서 SolarEdge 장비의 인벤토리를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
미터
|
Inventory.meters | array of object |
지정된 사이트의 미터 목록 |
|
이름
|
Inventory.meters.name | string |
미터 이름 |
|
manufacturer
|
Inventory.meters.manufacturer | string |
미터 제조업체 |
|
model
|
Inventory.meters.model | string |
미터 모델 |
|
firmwareVersion
|
Inventory.meters.firmwareVersion | string |
미터 펌웨어버전 |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– 미터가 연결된 SolarEdge 디바이스의 이름 |
|
type
|
Inventory.meters.type | string |
미터 유형(예: "Production") |
|
형
|
Inventory.meters.form | string |
다른 미터 간의 산술 연산으로 계산되는 경우 HW 미터 또는 가상에 대한 물리적 |
|
sensors
|
Inventory.sensors | array of object |
지정된 사이트에 대한 센서 목록 |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– 센서가 연결된 SolarEdge 디바이스의 이름 |
|
아이디
|
Inventory.sensors.id | string |
센서 ID |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
연결된 디바이스의 이름(예: "게이트웨이 1") |
|
카테고리
|
Inventory.sensors.category | string |
센서 범주(예: IRRADIANCE) |
|
type
|
Inventory.sensors.type | string |
센서 유형(예: "배열 조사 평면") |
|
gateways
|
Inventory.gateways | array of object |
지정된 사이트에 대한 게이트웨이 목록 |
|
이름
|
Inventory.gateways.name | string |
인버터 이름(예: Inverter 1)입니다. |
|
firmwareVersion
|
Inventory.gateways.firmwareVersion | string |
장비 펌워버전 |
|
SN
|
Inventory.gateways.SN | string |
장비 일련 번호(예: 7F123456-00) |
|
배터리
|
Inventory.batteries | array of object |
지정된 사이트의 배터리 목록 |
|
이름
|
Inventory.batteries.name | string |
배터리 이름 |
|
manufacturer
|
Inventory.batteries.manufacturer | string |
배터리 제조업체 |
|
model
|
Inventory.batteries.model | string |
배터리 모델 |
|
firmwareVersion
|
Inventory.batteries.firmwareVersion | string |
배터리 펌웨어버전 |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
– 배터리가 연결된 인버터/게이트웨이의 일련 번호 |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
제조업체에서 제공하는 배터리의 명판 용량 |
|
SN
|
Inventory.batteries.SN | string |
배터리 일련 번호 |
|
인버터
|
Inventory.inverters | array of object |
지정된 사이트에 대한 인버터 목록 |
|
이름
|
Inventory.inverters.name | string |
인버터 이름 |
|
manufacturer
|
Inventory.inverters.manufacturer | string |
인버터 제조업체 |
|
model
|
Inventory.inverters.model | string |
인버터 모델 |
|
firmwareVersion
|
Inventory.inverters.firmwareVersion | string |
인버터 펌웨어버전 |
|
SN
|
Inventory.inverters.SN | string |
인버터 serialnumber |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
인버터에 연결된 최적화 프로그램 수 |
사이트 전원
15분 해상도로 사이트 전원 측정값 반환
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
시작 날짜 및 시간
|
startTime | True | string |
전원 측정을 가져오는 시작 날짜 및 시간(yyyy-mm-dd hh:mm:ss) |
|
시작 날짜 및 시간
|
endTime | True | string |
전원 측정을 가져오는 시작 날짜 및 시간(yyyy-mm-dd hh:mm:ss) |
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
시간 단위(예: QUARTER_OF_AN_HOUR) |
|
단위
|
power.unit | string |
측정 단위(예: 와트) |
|
measuredBy
|
power.measuredBy | string |
측정 원본 |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
날짜와 시간 |
|
value
|
power.values.value | float |
지정된 날짜/시간에 측정된 전력(예: 와트) |
사이트 전원 - 자세한 정보
소비, 내보내기(피드인), 가져오기(구매) 등 미터의 자세한 사이트 전력 측정
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
|
에너지 측정 시작 시간
|
startTime | True | string |
에너지 측정 시작 시간(yyyy-MM-DD hh:mm:ss 형식) |
|
에너지 측정 종료 시간
|
endTime | True | string |
에너지 측정 종료 시간(yyyy-MM-DD hh:mm:ss 형식) |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
요청된 시간 단위 |
|
단위
|
powerDetails.unit | string |
측정 단위 |
|
미터
|
powerDetails.meters | array of object |
미터 |
|
type
|
powerDetails.meters.type | string |
미터 유형(Production/Consumption/SelfConsumption/FeedIn(export)/Purchased(import)) |
|
values
|
powerDetails.meters.values | array of object |
모든 날짜에 대한 날짜 및 전원 쌍 |
|
date
|
powerDetails.meters.values.date | string |
날짜와 시간 |
|
value
|
powerDetails.meters.values.value | float |
지정된 날짜/시간에 대한 전원 |
사이트 전원 흐름
PV 배열, 스토리지(배터리), 로드(사용량) 및 그리드를 포함하여 사이트의 모든 요소 간에 현재 전원 흐름을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
단위
|
siteCurrentPowerFlow.unit | string |
측정 단위(예: 와트) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
요소 간의 모든 관계와 전원 흐름 방향(요소 생성 및 요소 사용)을 포함하는 테이블입니다. |
|
보낸 사람
|
siteCurrentPowerFlow.connections.from | string |
전원을 제공하는 요소 |
|
에게
|
siteCurrentPowerFlow.connections.to | string |
소비하는 요소입니다. |
|
status
|
siteCurrentPowerFlow.GRID.status | string |
그리드 상태(활성/유휴/사용 안 함) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
현재 그리드 전원 |
|
status
|
siteCurrentPowerFlow.LOAD.status | string |
로드 상태(활성/유휴/사용 안 함) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
현재 부하 전원 |
|
status
|
siteCurrentPowerFlow.PV.status | string |
PV 상태(활성/유휴/사용 안 함) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
현재 PV 전원 |
|
status
|
siteCurrentPowerFlow.STORAGE.status | string |
스토리지 상태(활성/유휴/사용 안 함) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
현재 스토리지 전원 |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
스토리지 chargeLevel |
|
비판적인
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
스토리지가 중요합니까? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
백업 모드에서 스토리지가 다 떨어지기 전에 지정된 시간 |
사이트 환경 혜택
사이트 에너지 생산에 따른 모든 환경적 이점을 반환합니다. CO2 배출을 절약하고, 동급의 나무를 심고, 하루 동안 전력을 공급합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
단위
|
envBenefits.gasEmissionSaved.units | string |
결과의 나머지 부분에 대한 단위 |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
Kg 또는 Lb의 Co2 |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 in Kg 또는 Lb |
|
nox
|
envBenefits.gasEmissionSaved.nox | float |
Kg 또는 Lb의 NOX |
|
treesPlanted
|
envBenefits.treesPlanted | float |
CO2 수준을 줄이기 위한 새 트리의 동등한 심기 |
|
전구
|
envBenefits.lightBulbs | float |
사이트에서 하루 동안 전원을 공급할 수 있는 전구 수 |
센서 목록 가져오기
사이트의 모든 센서 및 센서가 연결된 디바이스의 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
사이트 센서 수 |
|
list
|
SiteSensors.list | array of object |
게이트웨이당 목록 |
|
connectedTo
|
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) |
|
type
|
SiteSensors.list.sensors.type | string |
센서 측정값(예: SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature) |
스토리지 정보
배터리에서 에너지, 전력 및 수명 에너지의 상태에 대한 자세한 저장 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
|
사이트 식별자
|
startTime | True | string |
사이트 식별자 |
|
사이트 식별자
|
endTime | True | string |
사이트 식별자 |
|
특정 배터리 일련 번호에 대해서만 데이터 반환
|
serials | string |
특정 배터리 일련 번호에 대해서만 데이터를 반환합니다. 목록은 쉼표로 구분됩니다. 생략하면 응답에 사이트의 모든 배터리가 포함됩니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
응답에 포함된 배터리 수 |
|
배터리
|
storageData.batteries | array of object |
배터리 개체 목록 |
|
이름표
|
storageData.batteries.nameplate | integer |
배터리의 명판(명목) 용량 |
|
serialNumber
|
storageData.batteries.serialNumber | string |
배터리 일련 번호 |
|
모델 번호
|
storageData.batteries.modelNumber | string |
배터리 모델 번호 |
|
telemetryCount
|
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 |
양수 전원은 배터리가 충전 중이고 음수가 방전 중임을 나타냅니다. |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
다음 0(유효하지 않음), 1(대기), 2(열 Mgmt.), 3(사용), 4(오류) 중 하나일 수 있습니다. |
|
lifeTimeEnergyCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
배터리 수명 동안 배터리에서 충전된 에너지(Wh) |
|
lifeTimeEnergyDischarged
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
배터리 수명 동안 배터리에서 배출된 에너지(Wh) |
|
fullPackEnergyAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
현재 배터리에 저장할 수 있는 최대 에너지(Wh) |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
배터리 내부 온도(섭씨) |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
지정된 날짜 범위 내의 그리드에서 배터리를 충전하는 데 사용되는 AC 에너지의 양(Wh) |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
사용 가능한 용량의 백분율로 충전된 배터리 상태입니다. 값의 범위는 0에서 100까지입니다. |
인버터 기술 데이터
지정된 기간에 대한 특정 인버터 데이터를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
|
장비의 일련 번호
|
equipment_id | True | string |
장비의 일련 번호 |
|
인버터 데이터를 가져올 시작(날짜 + 시간)
|
startTime | True | string |
인버터 데이터를 가져올 시작(날짜 + 시간) |
|
인버터 데이터를 가져올 끝(날짜 + 시간)
|
endTime | True | string |
인버터 데이터를 가져올 끝(날짜 + 시간) |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
count
|
data.count | integer |
응답 수 |
|
원격 분석
|
data.telemetries | array of object |
원격 분석 |
|
threePhaseInverterTelemetry
|
data.telemetries.threePhaseInverterTelemetry | array of object |
threePhaseInverterTelemetry |
|
date
|
data.telemetries.threePhaseInverterTelemetry.date | string |
date |
|
totalActivePower
|
data.telemetries.threePhaseInverterTelemetry.totalActivePower | string |
totalActivePower |
|
dcVoltage
|
data.telemetries.threePhaseInverterTelemetry.dcVoltage | float |
dcVoltage |
|
groundFaultResistance
|
data.telemetries.threePhaseInverterTelemetry.groundFaultResistance | float |
groundFaultResistance |
|
powerLimit
|
data.telemetries.threePhaseInverterTelemetry.powerLimit | float |
powerLimit |
|
totalEnergy
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
totalEnergy |
|
온도
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
섭씨 온도 |
|
inverterMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
인버터의 상태(예: OFF, STARTING, MPPT 등)입니다. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
작업 모드 정수 0 온-그리드, PV 또는 배터리를 사용하여 오프 그리드 모드에서 작동하는 1개, 생성기를 사용하여 오프 그리드 모드에서 작동하는 2개 |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acFrequency | float |
acFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.activePower | integer |
activePower |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L1Data.cosPhi | integer |
cosPhi |
|
vL1To2
|
data.telemetries.threePhaseInverterTelemetry.vL1To2 | float |
vL1To2 |
|
vL2To3
|
data.telemetries.threePhaseInverterTelemetry.vL2To3 | float |
vL2To3 |
|
vL3To1
|
data.telemetries.threePhaseInverterTelemetry.vL3To1 | float |
vL3To1 |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acFrequency | float |
acFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.activePower | integer |
activePower |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L2Data.cosPhi | integer |
cosPhi |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acFrequency | float |
acFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.activePower | integer |
activePower |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
장비 변경 로그
날짜별로 정렬된 장비 구성 요소 교체 목록을 반환합니다. 이 방법은 인버터, 최적화 프로그램, 배터리 및 게이트웨이에 적용할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사이트 식별자
|
site_id | True | integer |
사이트 식별자 |
|
장비의 일련 번호
|
equipment_id | True | string |
장비의 일련 번호 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
장비 짧은 일련 번호 |
|
부품번호
|
ChangeLog.list.partNumber | string |
인버터/배터리/최적화 프로그램/게이트웨이 모델 |
|
date
|
ChangeLog.list.date | string |
해당 장비 구성 요소 교체 날짜 |