# 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:

```bash title="V2 Prognose-API"
GET https://api.pvnode.com/v2/forecast/{site_id}
```

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 gemischter `required_data`-Listen.

:::note
Die V1 API bleibt unverändert und weiterhin verfügbar. Bestehende Integrationen funktionieren
weiter. Den Umstieg beschreibt der [Migrationsleitfaden](/de/v2/migration).
:::

## Die drei Bausteine

| Baustein | Zweck |
|---|---|
| **[Standorte](/de/v2/api/sites)** | PV-Anlagen anlegen und konfigurieren (Geometrie, Strings, Modultechnik, Verschattung, Tracker). |
| **[Prognosen](/de/v2/api/forecast)** | PV-Leistungsprognose für einen Standort, optional mit Wetter, Einstrahlung, Variabilitätsband. |
| **[Historische Daten](/de/v2/api/historical)** | 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](https://pvnode.com/sites)
  und fragen Prognosen per API ab.
- **Pro-/B2B-Nutzer** verwalten Standorte zusätzlich **programmatisch** über die API und können
  die [Inline-Endpunkte](/de/v2/enterprise/inline) nutzen — siehe
  [Enterprise](/de/v2/enterprise/index).

## Nächste Schritte

- **[Schnellstart](/de/v2/quickstart)** — vom API-Key zur ersten Prognose in wenigen Minuten.
- **[Standorte & Solarflächen](/de/v2/api/sites)** — das Datenmodell verstehen.
- **[API-Referenz](/api)** — vollständige Endpunkt-, Parameter- und Feldliste.