Deutsch
Einführung in die V2 API
Die pvnode V2 API ist die nächste Generation unserer Solar-API. Sie liefert präzise PV-Leistungsprognosen und historische Ertragsdaten über eine REST-Schnittstelle — jetzt rund um gespeicherte Standorte statt langer URL-Parameterketten.
Was ist neu gegenüber V1?
In der V1 wurde jede Anfrage komplett über URL-Parameter konfiguriert
(/v1/forecast?latitude=…&longitude=…&slope=…). In der V2 legen Sie einen Standort (Site)
einmal an und fragen ihn danach nur noch über seine site_id ab:
Code
Das bringt mehrere Vorteile:
- Feste Standorte mit einfacher, kurzer Abfrage — keine Wiederholung der Konfiguration.
- Mehrere PV-Strings pro Standort (unterschiedliche Ausrichtung/Neigung) in einem Modell.
include-Gruppen statt frei gemischterrequired_data-Listen.
Die V1 API bleibt unverändert und weiterhin verfügbar. Bestehende Integrationen funktionieren weiter. Den Umstieg beschreibt der Migrationsleitfaden.
Die drei Bausteine
| Baustein | Zweck |
|---|---|
| Standorte | PV-Anlagen anlegen und konfigurieren (Geometrie, Strings, Modultechnik, Verschattung, Tracker). |
| Prognosen | PV-Leistungsprognose für einen Standort, optional mit Wetter, Einstrahlung, Variabilitätsband. |
| Historische Daten | Vergangene PV-Erträge und Wetterdaten über frei wählbare Zeiträume. |
Hobby vs. Pro
- Hobby-Nutzer verwalten ihre Standorte über die pvnode Web-App und fragen Prognosen per API ab.
- Pro-/B2B-Nutzer verwalten Standorte zusätzlich programmatisch über die API und können die Inline-Endpunkte nutzen — siehe Enterprise.
Nächste Schritte
- Schnellstart — vom API-Key zur ersten Prognose in wenigen Minuten.
- Standorte & Solarflächen — das Datenmodell verstehen.
- API-Referenz — vollständige Endpunkt-, Parameter- und Feldliste.
Last modified on