API-Key Erstellen:

Im Portal in den Anlageneinstellungen können Sie unter API-Key Ihren API-Key erstellen.Dort wird Ihnen auch die benötigte Anlagen-ID angezeigt. Sollte der Menüpunkt nicht vorhanden sein, wenden Sie sich bitte an Ihren Installateur, dieser kann Ihnen dann einen Key erstellen.

Portal API abrufen:

URL: /api/pl

URL-Parameter:

• APIkey/APIKey/apikey/api_key
• Anlagen_id
  • Nummer enthalten in der Dashboard URL
• from/to
  • UTC Zeitstempel im Unix-Format (1577880000 -> 1.1.2020 12:00) oder "DD.MM.YYYY"
• interval
  • Leer = Anlagen-Info
  • 5mins, 15mins, daily, monthly, yearly
• type
  • plant, device, sensor, inverter, meter, battery, wallbox, stringbox, log, messages
  • kwk(noch nicht unterstützt)
  • devices, log und messages müssen momentan noch freigeschaltet werden
• ts (timestamp format, default str, epoch or str)

Response:

• Anlagen-Info
  • Name, Anlagenleistung, Straße, Hausnummer, Postleitzahl, Stadt, Jahressoll, Anlagen-Id, Land, ist_pv, hat_Verbrauch, hat_Batterie, ist_Eigenverbrauch
• Daten
  • Liste mit {Zeitstempel, Wert}
  • Ertrag, Verbrauch, Einspeisung, Bezug, Eigenverbrauch, Laden, Entladen

Beispiel-URL: http://xyreseller.data4.plexlog.de/api/pl?apikey=ah128dsjwd903ks09&plant_id=3829&from=17.3.20 22&to=17.4.2022&interval=daily

URL-Parameter für type=log (Logbuch) und type=messages (Meldungen):

• plant_id (required)
• from, to (optional, default: last 30 days)
• limit (default 100, max 500)
• offset (default 0)
• open (true = only entries without end date)
• msg_type (type=log only: 1 server, 2 logger, 3 deviation, 4 portal, 6 logger-mail)
• status (type=messages only: 0 open, 1 in progress, 2 done, 3 ignored)
• level, min_level (type=messages only: 0 unknown, 1 normal, 2 warning, 3 error)

Anfragen-Zählen:

• Anlage: Jeder Ruf ist eine Anfrage
• Gerät: Wenn der Intervall 5 oder 15-Minuten ist, ist jeder Tag eine Anfrage.

Plexlog Portal-API für Reseller/Kunden Summen

URL:

Reseller-Key: /api/pl?reseller_id=XY&api_key=XYZ&interval=day/month/year/all

Customer-Key: /api/pl?customer_id=XY&api_key=XYZ&interval=day/month/year/all

Data:

• Tag: Array mit der Länge 48, jeder Eintrag ist eine halbe Stunde des tatsächlichen Tages
• Monat: Alle Tage des aktuellen Monats
• Jahr: Alle Monate des aktuellen Jahres
• Alle: Alle Jahre

Datenpunkte in Watt oder Wh, Summe in kWh

Eine Liste der Anlagen gibt es mit type=plants ohne den interval Parameter