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.
| Interval | Maximaal bereik |
|---|---|
| 5m | 7 dagen |
| 15m | 31 dagen |
| 1h | 92 dagen |
| 1d | 730 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
429metRetry-After. 400ongeldige parameters of te groot bereik ·401key ongeldig ·404site of asset niet toegekend, of adres niet beschikbaar ·502databron fout.