Obligatorisk information, konfiguration och verifiering för Solarman (API).
Eniris kan läsa dina anläggnings- och enhetsdata via det officiella SOLARMAN Open API. Du ber Solarman om API-åtkomst en gång. Därefter skickar du fyra värden till Eniris via vår supportportal.
En tillförlitlig API-anslutning kombinerar rätt auktoriseringsmetod, en uttryckligen begränsad installationsomfattning och en verifierad första hämtning.
Anslutningstyp: API- och plattformsanslutning.
Se till att du har:
globalapi.solarmanpv.com). Konton på det kinesiska datacentret kan inte läsas av denna anslutning.API-åtkomst är inte aktiverad som standard. Skicka din begäran till din affärskontakt hos Solarman eller till serviceadressen service@solarmanpv.com. Solarman vill veta vem du är, vilken typ av kund du är och vad du ska använda API:et till. Deras Open API-dokumentation beskriver proceduren. Du kan också öppna ett ärende hos SOLARMAN Help Centre.
Använd mallen nedan. Ersätt värdena inom vinkelparenteser och ta bort det som inte är tillämpligt.
Subject: OpenAPI activation request for <your Solarman account email>
Dear Solarman support,
I would like to activate the OpenAPI for my SOLARMAN account.
Solarman account (email): <your Solarman login>
Platform: SOLARMAN Smart / SOLARMAN Business
Data centre: International
Customer type: individual / equipment manufacturer / installation and
maintenance provider / distributor / investor
Number of plants: <number>
Reason: my PV installation is monitored by Eniris (https://eniris.com).
Eniris reads my plant and device data through the SOLARMAN OpenAPI for
monitoring and reporting.
Please send the APP ID and APP SECRET to this email address.
Kind regards,
<name>, <company>
Solarman registrerar dig som utvecklare och skapar applikationen. Därefter genomgår applikationen en granskning. Solarman kan be dig bekräfta API Developer Agreement via e-post till customerservice@solarmanpv.com innan aktiveringen fortsätter.
När granskningen är klar aktiverar Solarman API:et och skickar APP ID och APP SECRET till din e-postadress.
Du behöver inte själv skapa en åtkomsttoken eller en uppdateringstoken. Eniris tar hand om det med hjälp av värdena nedan.
| Information / inställning | Vad som behövs |
|---|---|
Applikations-ID (APP_ID) | Utfärdas av Solarman efter API-aktivering. |
Applikationshemlighet (APP_SECRET) | Hemlighet som hör till detta APP ID. |
Kontots e-postadress (EMAIL) | Det Solarman-konto som kan se anläggningarna. |
Kontots lösenord (PASSWORD) | Lösenordet för detta konto. |
| Anläggningsomfattning | De anläggningar som Eniris får läsa. |
Använd om möjligt ett separat Solarman-konto för Eniris och dela de relevanta anläggningarna med det. Det är säkrare än att lämna ut en personlig inloggning eller en administratörsinloggning.
Viktigt: behandla APP SECRET och kontolösenordet som lösenord. Klistra aldrig in dem i ett e-postmeddelande, ett ärende eller ett chattmeddelande.
Dela hemligheten och lösenordet via en engångslänk för hemligheter och lägg länken i ett supportärende. Då lagras inget i klartext.
Länken kan endast öppnas en gång. När Eniris har läst den kan ingen annan öppna den.
Kopiera detta till ärendet. Lämna anläggningslistan tom om du vill inkludera alla anläggningar.
Subject: New Solarman (API) connection
Hello Eniris team,
We would like to connect our Solarman installation through the official
Solarman Open API.
APP ID: <your APP ID>
Solarman account (email): <your Solarman login>
APP SECRET and password (one-time secret link): <paste link here>
Plants to collect:
Kind regards,
:::caution Om du ändrar ditt Solarman-lösenord stoppas datainsamlingen Solarman blockerar API-åtkomsten så snart kontolösenordet återställs eller ändras. Detsamma händer när kontots roll ändras. Anslutningen slutar då att samla in data, och inga data lagras för den perioden. Öppna ett ärende innan du ändrar lösenordet och skicka de nya autentiseringsuppgifterna via en ny engångslänk för hemligheter. Då kan vi uppdatera anslutningen samma dag. :::
Vad vi samlar in beror på din utrustning.
| Nivå | Vad som samlas in |
|---|---|
| Anläggning | Namn, installerad kapacitet, tidszon, koordinater, adress, driftsättningsdatum, genereringseffekt och produktion |
| Växelriktare | Total AC-effekt, total avkastning, fasspänningar, huvudspänningar och fasströmmar |
| Hybridväxelriktare | Total AC-effekt, importerad och exporterad energi |
| Batteri | Laddningsnivå, hälsotillstånd, laddad och urladdad energi, effekt, ström och spänning |
| Optimerare | Spänning, ström, effekt och avkastning per optimerare |
| Nätmätare | Total effekt och effekt per fas, reaktiv effekt, huvudspänningar, importerad och exporterad energi |
| Förbrukningsmätare | Importerad energi och effekt |
| Larm | Enhetslarm, kopplade till den enhet de tillhör |
Solarman beslutar villkoren för API-åtkomst och kan ta betalt för den. Det beror på din plattform, antalet anläggningar och hur många anrop som behövs. Fråga Solarman vad som gäller för ditt konto när du begär aktivering. Deras villkor för API-åtkomst sida innehåller den aktuella översikten.
Har du frågor om stegen ovan? Kontakta Eniris support så hjälper vi dig vidare.
Alla guider för anslutningskonfiguration