# 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](https://pvnode.com/auth/register))
- Ein API-Key ([im Dashboard erstellen](https://pvnode.com/settings/api-keys))

Alle V2-Anfragen authentifizieren sich per Bearer-Token:

```bash
Authorization: Bearer IHR_API_KEY
```

## 1. Standort anlegen

Sie können über unsere [pvnode Web-App](https://pvnode.com/sites/new) einen neuen Standort anlegen. Enterprise- oder
B2B-Nutzer können zusätzlich die [Sites API](/de/v2/enterprise/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](https://pvnode.com/sites)
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.

```python title="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])
```

```json title="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:

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

Die vollständige Liste der Gruppen finden Sie unter [Prognosen](/de/v2/api/forecast).

:::tip
Kein persistenter Standort nötig? Enterprise-Nutzer können die [Inline-Endpunkte](/de/v2/enterprise/inline)
nutzen, sofern im Plan verfügbar, und die Konfiguration direkt im Request mitschicken.
:::

## Nächste Schritte

- **[Standorte & Solarflächen](/de/v2/api/sites)** — alle Konfigurationsoptionen.
- **[Prognosen](/de/v2/api/forecast)** — `include`-Gruppen, Variabilität, Caching.
- **[API-Referenz](/api)** — vollständige Parameter- und Feldliste.