# Inline-Endpunkte

Die **Inline-Endpunkte** liefern dieselben Ergebnisse wie die Standort-basierten Endpunkte, nur
**ohne vorher einen Standort anzulegen**. Die Konfiguration (Koordinaten, Strings, Config) steht
direkt im Request-Body.

```bash
POST /v2/forecast/inline
POST /v2/historical/inline
```

Ideal für einmalige Berechnungen, Standortvergleiche, „Was-wäre-wenn"-Szenarien und
Massenauswertungen, bei denen sich das persistente Anlegen von Standorten nicht lohnt.

## Request

Pflicht sind `latitude` und `longitude`. Ohne `strings` wird ein einzelner Standard-String
verwendet (10 kWp, 180° Ausrichtung, 30° Neigung). `elevation` und `timezone` werden zur Laufzeit
aus dem Standort ermittelt.

```bash title="Forecast inline (curl)"
curl -X POST https://api.pvnode.com/v2/forecast/inline \
  -H "Authorization: Bearer IHR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": 48.8566,
    "longitude": 2.3522,
    "strings": [{"slope": 30, "orientation": 180, "power_kw": 10}],
    "config": {"modules": {"technology": "topcon"}}
  }'
```

Query-Parameter (`forecast_days`, `past_days`, `include` bzw. `period`/`start_date`/`end_date`,
`include`) funktionieren wie bei den Standort-Endpunkten — siehe [Prognosen](/de/v2/api/forecast)
und [Historische Daten](/de/v2/api/historical).

## Antwort

Die Antwortstruktur ist identisch zu den Standort-Endpunkten (`values`, bei Forecast zusätzlich
`daily`, optional der `strings`-Block, standardmäßig lokale Zeitstempel — mit `?timezone=utc` in
UTC). Da kein Standort existiert, gibt es keine `site_id`-gebundene Verwaltung.

## Unterschiede zu Standort-Endpunkten

| | Standort-Endpunkt | Inline |
|---|---|---|
| Konfiguration | Aus gespeichertem Standort | Im Request-Body |
| **Caching** | Ja (feste Slots/Tag) | **Nein** — jede Anfrage rechnet neu |
| Höhe/Zeitzone | Gespeichert | Zur Laufzeit ermittelt |

:::note
Ohne Cache rechnet **jede** Inline-Anfrage frisch. Für wiederkehrende Abfragen desselben
Standorts ist ein gespeicherter Standort effizienter und schont das Anfragelimit.
:::

## Limits & Fehler

Es gelten dieselben Plan-Gates und Quotas wie bei den Standort-Endpunkten:

- Zugriff zur Forecast- bzw. Historical-API → ohne Zugang **403**.
- Monatliches Anfragelimit → **429**.
- Strings pro Standort begrenzt die Anzahl der `strings` im Request → **422**.

Ihre konkreten Limits finden Sie auf der Seite über [Nutzung & Limits](https://pvnode.com/usage).