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.

Code
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.

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 und Historische Daten.

Antwort

Die Antwortstruktur ist identisch zu den Standort-Endpunkten (values, bei Forecast zusätzlich daily, optional der strings-Block, lokale Zeitstempel). Da kein Standort existiert, gibt es keine site_id-gebundene Verwaltung.

Unterschiede zu Standort-Endpunkten

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.