Enphase

Overzicht

Welkom bij het Enphase Developer Portal. Als ontwikkelaar en installateur kun je via dit portaal toegang krijgen tot gegevens van Enphase-systemen. Iedereen kan zich registreren op het platform, een applicatie aanmaken en toegang krijgen tot systeemgegevens.

De Enphase Public API is een REST API die voldoet aan alle vereisten van de REST-architectuurstijl en levert gegevens in JSON-formaat via HTTPS. De API is onderverdeeld in twee producten:

• Monitoring API
• Commissioning API

De Monitoring API kan systeemgegevens op een locatie ophalen, zoals productie-, verbruiks- en batterijgegevens op systeemniveau, productiegegevens per apparaat, systeemconfiguraties en live status. De Commissioning API kan worden gebruikt om activaties op een locatie aan te maken en bij te werken, bedrijven en gebruikers te beheren, tarieven bij te werken, enz.

Dit document biedt een stapsgewijze handleiding voor:

• Een account aanmaken op het portaal
• Applicatiegegevens invoeren
• Een plan kiezen en toegangsrechten selecteren
• Authenticatie- en autorisatieproces voor een ontwikkelaarsapp
• Authenticatie- en autorisatieproces voor een partnerapp

Een account aanmaken op het portaal

Om te beginnen met het developer portaal, meld je aan voor een gratis ontwikkelaarsaccount. Bezoek de aanmeldpagina, vul de gevraagde gegevens in en voltooi de registratie. Je ontvangt een e-mail met instructies om je account te activeren. Volg de instructies in de e-mail om je account te activeren.

Let op: Door gebruik te maken van de API ga je akkoord met de Enphase Energy API Licentieovereenkomst.

Applicatiegegevens invoeren

Na activatie van je account, log je in op het portaal en ga je naar de pagina “Applications”.

Vul de volgende velden in om een nieuwe applicatie aan te maken:

• Plan – Geeft het gekozen plan aan. Standaard is dit “Watt”, maar dit kan worden gewijzigd naar “Kilowatt” of “Megawatt”. Voor het partnerplan moet een nieuwe applicatie worden aangemaakt.
• Naam – Naam van de applicatie. Deze naam wordt getoond aan systeemeigenaren wanneer je toegang tot hun gegevens aanvraagt. Bij goedkeuring wordt de naam ook getoond in de Enphase App.
• Beschrijving – Een beschrijving van wat je applicatie doet.
• Ontwikkeld door – Geeft aan wie de ontwikkelaar is. Deze naam wordt ook getoond in de Enphase App.
• Toegangscontrole – Wordt ingevuld op basis van het gekozen plan. Standaard is alles uitgevinkt; de geselecteerde toegangsrechten bepalen de reikwijdte van de applicatie.

Plan kiezen en toegangsrechten selecteren

Er zijn meerdere plannen beschikbaar op het portaal. Standaard worden applicaties aangemaakt onder het “Watt”-plan. Applicaties onder dit plan krijgen gratis toegang tot enkele eindpunten, maar met lagere limieten.

Ontwikkelaars kunnen kiezen uit de plannen Watt, Kilowatt of Megawatt. Afhankelijk van het gekozen plan wordt de reikwijdte van de applicatie bepaald. Bijvoorbeeld: applicaties onder het Watt-plan krijgen toegang tot eindpunten voor systeemdetails, productie op locatie en verbruik op locatie. Applicaties onder het Kilowatt-plan krijgen daarnaast toegang tot productiegegevens per apparaat en streaming API’s. Het partnerplan is alleen beschikbaar voor geregistreerde Enphase-installateurs met minimaal 10 installaties en biedt toegang tot alle Monitoring API- en Commissioning API-eindpunten. De volledige lijst met beschikbare eindpunten per categorie is te vinden op de documentatiepagina.

Na het invullen van de verplichte velden, ga je verder met “create application”. Voor een betaald plan moeten creditcardgegevens worden ingevoerd op de volgende pagina – “Enter Payment Details”.