Vereiste informatie, configuratie en verificatie voor Solarman (API).
Eniris kan uw installatie- en apparaatgegevens uitlezen via de officiële SOLARMAN Open API. U vraagt Solarman één keer om API-toegang. Daarna stuurt u vier waarden naar Eniris via ons supportportaal.
Een betrouwbare API-verbinding combineert de juiste autorisatiemethode, een expliciet beperkt installatiebereik en een geverifieerde eerste gegevensophaling.
Verbindingstype: API- en platformverbinding.
Zorg dat u het volgende hebt:
globalapi.solarmanpv.com). Accounts op het Chinese datacentrum kunnen door deze connector niet worden uitgelezen.API-toegang is standaard niet ingeschakeld. Stuur uw aanvraag naar uw zakelijke contactpersoon bij Solarman of naar het serviceadres service@solarmanpv.com. Solarman wil weten wie u bent, welk type klant u bent en waarvoor u de API gaat gebruiken. Hun Open API-documentatie beschrijft de procedure. U kunt ook een ticket openen bij het SOLARMAN Help Centre.
Gebruik het onderstaande template. Vervang de waarden tussen punthaken en verwijder wat niet van toepassing is.
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 registreert u als ontwikkelaar en maakt de applicatie aan. De applicatie wordt vervolgens beoordeeld. Solarman kan u vragen de API Developer Agreement per e-mail te bevestigen aan customerservice@solarmanpv.com voordat de activering wordt voortgezet.
Wanneer de beoordeling is afgerond, activeert Solarman de API en stuurt het APP ID en APP SECRET naar uw e-mailadres.
U hoeft zelf geen access token of refresh token aan te maken. Eniris regelt dit met de onderstaande waarden.
| Informatie / instelling | Wat nodig is |
|---|---|
Applicatie-ID (APP_ID) | Uitgegeven door Solarman na activering van de API. |
Applicatiegeheim (APP_SECRET) | Geheim dat bij dat APP ID hoort. |
E-mailadres van account (EMAIL) | Het Solarman-account waarmee de installaties zichtbaar zijn. |
Wachtwoord van account (PASSWORD) | Wachtwoord van dat account. |
| Bereik van installaties | De installaties die Eniris mag uitlezen. |
Gebruik waar mogelijk een afzonderlijk Solarman-account voor Eniris en deel de relevante installaties ermee. Dat is veiliger dan een persoonlijke of beheerderslogin over te dragen.
Belangrijk: behandel het APP SECRET en het accountwachtwoord als wachtwoorden. Plak ze nooit in een e-mail, ticket of chatbericht.
Deel het geheim en het wachtwoord via een eenmalige geheime koppeling en plaats die koppeling in een supportticket. Er wordt dan niets als platte tekst opgeslagen.
De koppeling kan slechts één keer worden geopend. Nadat Eniris deze heeft uitgelezen, kan niemand anders dat nog.
Kopieer dit naar het ticket. Laat de lijst met installaties leeg als u alle installaties wilt.
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 Als u uw Solarman-wachtwoord wijzigt, stopt het verzamelen van gegevens Solarman blokkeert de API-toegang zodra het accountwachtwoord opnieuw wordt ingesteld of gewijzigd. Hetzelfde gebeurt wanneer de rol van het account verandert. De verbinding stopt dan met verzamelen en voor die periode worden geen gegevens opgeslagen. Open een ticket voordat u het wachtwoord wijzigt en stuur de nieuwe inloggegevens via een nieuwe eenmalige geheime koppeling. We kunnen de verbinding dan nog dezelfde dag bijwerken. :::
Wat we verzamelen, hangt af van uw apparatuur.
| Niveau | Wat wordt verzameld |
|---|---|
| Installatie | Naam, geïnstalleerd vermogen, tijdzone, coördinaten, adres, ingebruiknamedatum, opwekkingsvermogen en productie |
| Omvormer | Totaal AC-vermogen, totale opbrengst, fasespanningen, lijnspanningen en fasestromen |
| Hybride omvormer | Totaal AC-vermogen, geïmporteerde en geëxporteerde energie |
| Accu | Laadstatus, gezondheidsstatus, geladen en ontladen energie, vermogen, stroom en spanning |
| Optimizer | Spanning, stroom, vermogen en opbrengst per optimizer |
| Netmeter | Totaal vermogen en vermogen per fase, reactief vermogen, lijnspanningen, geïmporteerde en geëxporteerde energie |
| Verbruiksmeter | Geïmporteerde energie en vermogen |
| Alarmen | Apparaatmeldingen, gekoppeld aan het apparaat waarbij ze horen |
Solarman bepaalt de voorwaarden voor API-toegang en kan hiervoor kosten in rekening brengen. Dit hangt af van uw platform, het aantal installaties en het aantal benodigde aanroepen. Vraag Solarman bij uw activeringsaanvraag wat voor uw account van toepassing is. Hun voorwaarden voor API-toegang-pagina bevat het actuele overzicht.
Hebt u vragen over de bovenstaande stappen? Neem contact op met Eniris-support; wij helpen u verder.
Alle handleidingen voor het instellen van verbindingen