SMA API

Last modified: 27 Nov 2024

Set up SMA API

General tips

Have the data source (data logger, etc.) serial number on hand. When entering the serial number, pay attention to uppercase and lowercase letters and empty spaces.
The data source name can be freely selected. For recommendations, see our Naming guideline.
Set the same measuring interval for all data sources in the system to ensure charts are accurately displayed in VCOM. This is used to normalize uneven timestamps and aggregate smaller recorded intervals into larger ones.
To ensure that the data source measuring interval has been set correctly in VCOM, open an imported file in the Data logger overview portlet in VCOM and check the timestamps.
If possible, perform a connection test once you have completed the configuration in both VCOM and the data source.

Protocol	HTTPS Pull
File format	JSON
Query interval	hourly
Server	ftp.sspcdn-a.net
Port	21
Client ID	Refer to manufacturer documentation
Client secret	Refer to manufacturer documentation
Plant ID	In the Sunny Portal powered by ennexOS UI, the Monitoring API plant and device IDs are part of the URL when navigating to the corresponding plant/device. In the Sunny Portal classic UI, the Monitoring API plant ID is part of the URL when clicking on the PV System Logbook navigation tree item. The Monitoring API device IDs are not displayed on the Sunny Portal UI. Plant ID with Sunny Portal

Allow your plant to access the API.