Copy page

Deutsch

Schnellstart

In wenigen Minuten von der Registrierung zur ersten Prognose. Der V2-Workflow ist immer gleich: Standort anlegen → über site_id abfragen.

Voraussetzungen

• Ein pvnode-Account (kostenlos registrieren)
• Ein API-Key (im Dashboard erstellen)

Alle V2-Anfragen authentifizieren sich per Bearer-Token:

Code
Authorization: Bearer IHR_API_KEY

1. Standort anlegen

Sie können über unsere pvnode Web-App einen neuen Standort anlegen. Enterprise- oder B2B-Nutzer können zusätzlich die Sites API nutzen, sofern im Plan verfügbar.

Nach der Erstellung des Standortes wird Ihnen die site_id angezeigt, die Sie im nächsten Schritt benötigen. Sie können den Standort weiter konfigurieren oder mit der Standard-Konfiguration starten. Standardmäßig ist eine nach Süden ausgerichtete Solarfläche voreingestellt.

Bereits hinzugefügte Standorte können Sie sich auf einer interaktiven Standort-Karte ansehen.

2. Prognose abfragen

Fragen Sie den Standort über seine site_id ab. Standardmäßig kommt pv_power je Zeitschritt (15-Minuten-Intervalle) zurück.

forecast.py
import requests

resp = requests.get(
    "https://api.pvnode.com/v2/forecast/site_rv8wm5…",
    headers={"Authorization": "Bearer IHR_API_KEY"},
)
data = resp.json()
print(data["values"][0])

Antwort (200 OK)
{
  "site_id": "site_rv8wm5…",
  "timezone": "Europe/Paris",
  "computed_at": "2026-06-09T08:00:00",
  "included": [
    "default"
  ],
  "daily": [
    {
      "date": "2026-06-09",
      "pv_energy_kwh": 42.7
    }
  ],
  "values": [
    {
      "timestamp": "2026-06-09T00:00:00",
      "pv_power": 0.0
    },
    {
      "timestamp": "2026-06-09T00:15:00",
      "pv_power": 0.0
    }
  ]
}

3. Mehr Felder anfordern

Über include steuern Sie, welche Feldgruppen zurückkommen — z.B. Wetter und Einstrahlung:

Code
GET /v2/forecast/{site_id}?include=weather&include=irradiance

Die vollständige Liste der Gruppen finden Sie unter Prognosen.

Nächste Schritte

• Standorte & Solarflächen — alle Konfigurationsoptionen.
• Prognosen — include-Gruppen, Variabilität, Caching.
• API-Referenz — vollständige Parameter- und Feldliste.