Sites API

Mit der Sites API verwalten Sie Standorte vollständig per API — ohne die pvnode Web-App. Das ist die programmatische Variante der unter Standorte & Solarflächen beschriebenen Konzepte.

Endpunkte im Überblick

Die genauen Request-/Response-Schemata stehen in der API-Referenz.

Anlegen

Pflicht sind latitude und longitude. elevation, timezone und der Geländehorizont werden automatisch ermittelt. Ohne strings wird ein einzelner Standard-String angelegt.

curl
curl -X POST https://api.pvnode.com/v2/sites \
  -H "Authorization: Bearer IHR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Dach Süd",
    "latitude": 48.8566,
    "longitude": 2.3522,
    "strings": [{"slope": 30, "orientation": 180, "power_kw": 10}]
  }'

Aktualisieren (PATCH)

Partielles Update — nur gesendete Felder ändern sich. Beachten Sie:

• strings ersetzt das gesamte Array. Jeder String hat eine stabile, vom Server vergebene id — geben Sie sie mit zurück, um den String zu behalten (samt seiner Daten, z. B. Messwerte); lassen Sie sie weg, wird der String entfernt; senden Sie einen String ohne id, wird ein neuer angelegt. Der Prognose-strings-Block führt diese id als string_id (plus positionsbasierten string_index); lesen Sie Standort und Prognose vom selben Zeitpunkt.
• Eine Standortänderung (Koordinaten) löst eine Neuermittlung von Höhe, Zeitzone und Horizont aus und macht den Prognose-Cache ungültig.
• Standortwechsel sind auf 1 pro 30 Tage je Standort begrenzt (planunabhängig) → sonst 429.

curl
curl -X PATCH https://api.pvnode.com/v2/sites/{site_id} \
  -H "Authorization: Bearer IHR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"config": {"modules": {"technology": "topcon"}}}'

Löschen & Wiederherstellen

DELETE markiert den Standort als „pending deletion" (deleted_at gesetzt); die endgültige Entfernung erfolgt 30 Tage später. Innerhalb dieser Frist stellt POST .../restore den Standort wieder her.

Limits & Fehler

Die vollständige Referenz aller Felder und Fehlercodes steht in der API-Referenz.