Gebruik stroomprijs en CO2 in Homey zonder direct een eigen Homey-app te bouwen

Belangrijke logica vroeg uitgelegd

De prijslogica is ook voor Homey niet simpelweg “alleen forecast”. Ze werkt bewust in twee stappen, zodat echte marktdata altijd voorrang houden zodra ze beschikbaar zijn.

Aanbevolen startpunt: summary

Voor Homey is er een eigen summary-pad. Technisch ligt het dicht bij de andere automation-endpoints, maar de structuur en naamgeving zijn bewust afgestemd op HomeyScript en Advanced Flow.

Wat de API precies teruggeeft

De Homey-endpoint levert een compacte automation-weergave. Dat is belangrijk, omdat je in Homey meestal niet wilt starten met een complete ruwe tijdreeks, maar met een paar heldere waarden voor Flows.

Periode en resolutie

De voorbeelden gebruiken hours=48 en window_hours=4. Dat is een goed startpunt, maar niet de volledige productgrens.

Zo gebruik je dit in Advanced Flow

1. Installeer HomeyScript.
2. Maak in Advanced Flow een tijdtrigger, bijvoorbeeld elke 15 minuten.
3. Voeg daarna een HomeyScript-kaart toe met returntype Number, Yes/No of Text.
4. Plak een van de copy-paste-blokken hieronder.
5. Gebruik de result-tag in de volgende Flow-stap.

Homey beschrijft HomeyScript expliciet als manier om website-API’s te benaderen. De onderstaande voorbeelden gebruiken precies dat met de Homey-summary-endpoint.

Voorbeeld 1: actuele prijs als Number teruggeven

Handig als je op drempelwaarden of vergelijkingen wilt sturen.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&hours=48&window_hours=4';

const response = await fetch(url, {
  headers: API_KEY.trim()
    ? { Authorization: `Bearer ${API_KEY.trim()}` }
    : {},
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
return Number(data.flat?.current_price ?? 0);

Voorbeeld 2: loopt het beste prijsvenster nu?

Voor echte automatiseringen is dat vaak belangrijker dan alleen weten wanneer het volgende venster start.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&hours=48&window_hours=4';

const response = await fetch(url, {
  headers: API_KEY.trim()
    ? { Authorization: `Bearer ${API_KEY.trim()}` }
    : {},
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
return data.flat?.is_cheapest_window_now === true;

Voorbeeld 3: volgende volledige start als Text teruggeven

Praktisch voor planning, dashboards of meldingen.

const API_KEY = '';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&hours=48&window_hours=4';

const response = await fetch(url, {
  headers: API_KEY.trim()
    ? { Authorization: `Bearer ${API_KEY.trim()}` }
    : {},
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
return String(data.price?.next_full_window?.start || '');

Optioneel met API-key

Als je meer dan de vrije horizon wilt testen, zet je de key direct in het script. De API verwacht op dit moment een Bearer-header.

const API_KEY = 'JOUW_API_KEY';
const url = 'https://api.energypriceforecast.eu/api/v1/homey/summary?country=nl&hours=120&window_hours=4';

Doorslaggevend is uiteindelijk niet alleen wat je in de URL vraagt, maar wat de server in meta.allowed_horizon_hours echt toestaat.

Typische Homey-use-cases

Belangrijke meta-velden voor debug