REST API · v1

API-documentatie

Basis-URL: https://jouw-app.lovable.app/api/public/v1

Authenticatie

Een token geeft toegang tot precies één toegekende site. Stuur je token mee in de header X-API-Key. Ingetrokken of onbekende keys krijgen 401.

GET /sites/{site_id}/assets

Lijst van meters, solar- en bess-assets binnen jouw site; meerdere assets van hetzelfde type hebben elk hun eigen ID.

curl -H "X-API-Key: sk_live_..." \
  https://jouw-app.lovable.app/api/public/v1/sites/SITE_ID/assets
{ "data": [ { "id": "3f2c…", "name": "Solar 1", "fields": ["powerWatt"] } ] }

GET /sites/{site_id}/assets/{id}/data

Gemiddelde waarden per interval. Parameters: start, end (ISO-8601) en interval.

IntervalMaximaal bereik
5m7 dagen
15m31 dagen
1h92 dagen
1d730 dagen
curl -G -H "X-API-Key: sk_live_..." \
  --data-urlencode "start=2026-11-01T00:00:00Z" \
  --data-urlencode "end=2026-11-02T00:00:00Z" \
  --data-urlencode "interval=1h" \
  https://jouw-app.lovable.app/api/public/v1/sites/SITE_ID/assets/ASSET_ID/data
const res = await fetch(
  "https://jouw-app.lovable.app/api/public/v1/sites/SITE_ID/assets/ASSET_ID/data?start=2026-11-01T00:00:00Z&end=2026-11-02T00:00:00Z&interval=15m",
  { headers: { "X-API-Key": process.env.DATAHUB_KEY } }
);
const { data } = await res.json();
import requests
r = requests.get("https://jouw-app.lovable.app/api/public/v1/sites/SITE_ID/assets/ASSET_ID/data",
    headers={"X-API-Key": "sk_live_..."},
    params={"start": "2026-11-01T00:00:00Z", "end": "2026-11-08T00:00:00Z", "interval": "1h"})
print(r.json()["data"])
{ "asset": { "id": "3f2c…", "name": "Solar 1" }, "interval": "1h",
  "start": "2026-11-01T00:00:00.000Z", "end": "2026-11-02T00:00:00.000Z",
  "data": [ { "bucket": "2026-11-01T00:00:00", "powerWatt": 1250 } ] }

Sites en batterijen

GET /sites toont de site van het token. Een site is één Influx-bucket. Meetinstellingen en veldmapping worden gedeeld per type; elk asset heeft een eigen Influx-ID.

curl -H "X-API-Key: sk_live_..." https://jouw-app.lovable.app/api/public/v1/sites

Batterijmetingen komen uit de masterunit met een ingevulde assetIdentifier. Racks zijn niet beschikbaar via de API. Alle meetdata wordt gegroepeerd per tijdinterval met avg/mean; het minimuminterval is 5 minuten.

Limieten en fouten

  • Maximaal 60 verzoeken per minuut per key; daarboven 429 met Retry-After.
  • 400 ongeldige parameters of te groot bereik · 401 key ongeldig · 404 site of asset niet toegekend, of adres niet beschikbaar · 502 databron fout.