Dagelijks Woord is ook te gebruiken op de Home Assistant domotica software.

Let op: deze pagina bevat diverse links naar externe websites die buiten de verantwoordelijkheid van Stichting Dagelijks Woord vallen. Gebruik op eigen risico.

1. Vraag een API key voor de REST API aan bij via https://www.dagelijkswoord.nl/verspreiden/json-feed

2. In Home Assistant, voeg een sensor toe in configuration.yaml, van het type platform ‘rest’. Zie https://www.home-assistant.io/integrations/rest/ voor meer informatie.

In onderstaande afbeelding is een sensor ‘dagelijkswoord’ aangemaakt. Deze haalt de JSON op van dagelijkswoord.nl via https://feed.dagelijkswoord.nl/api/json/1.0/. De sensor heeft 3 attributes te weten:

1. ts
2. source
3. text

Deze attribute benamingen komen overeen met de benamingen die in de JSON staan.

Eventueel is het mogelijk om enkele sensors van het type platform ‘template’ aan te maken, om bijv. het Bijbelgedeelte en de Bijbeltekst op te halen in losse sensors. Echter, een beperking van een sensor is dat deze maar maximaal 255 karakters kan bevatten. Bij een te lange Bijbeltekst zal de sensor de waarde ‘unknown’ tonen. Een attribute van een sensor heeft deze beperking niet.

- platform: rest

  name: dagelijkswoord

  json_attributes_path: "$.data[0]"

  json_attributes:

    - ts

    - source

    - text

  resource: https://feed.dagelijkswoord.nl/api/json/1.0/

  username: your-email@example.com

  password: 111111111111111111111111111111111111

  # Please do not request more than once an hour. The verse only updates once a day.
  scan_interval: 3600

  value_template: "OK"

  authentication: basic

  headers:

    Content-Type: application/json



- platform: template

  sensors:

    dagelijkswoord_datum:

      friendly_name: Datum

      value_template: '{{ states.sensor.dagelijkswoord.attributes["ts"] }}'

    dagelijkswoord_bron:

      friendly_name: Bron

      value_template: '{{ states.sensor.dagelijkswoord.attributes["source"] }}'

    dagelijkswoord_tekst:

      friendly_name: Bijbeltekst

      value_template: '{{ state_attr("sensor.dagelijkswoord", "text")["hsv"]|truncate(254,True) }}'

3. De sensoren en attributen getoond in de ‘Ontwikkelhulpmiddelen’ pagina.

De sensor ‘dagelijkswoord_tekst’ laat hier nu een goede waarde zien, maar zoals gezegd, bij een Bijbeltekst langer dan 255 karakters werkt dit niet. Gelukkig kunnen we de attributes van de sensor ‘dagelijkswoord’ gebruiken.

4. Toevoegen aan lovelace dashboard. Hiervoor kan het beste een kaart van het type ‘markdown’ gebruikt worden. De configuratie ziet er als volgt uit:

type: markdown
content: |-
  {{ state_attr("sensor.dagelijkswoord", "text")["hsv"] }}

  -- {{ state_attr("sensor.dagelijkswoord", "source")}}
title: Dagelijks Woord

Er wordt gebruik gemaakt van de attribute ‘text’ van de sensor ‘dagelijkswoord’. Bij de attribute worden blokhaken gebruikt om de juiste Bijbelvertaling te tonen, in dit geval ‘hsv’ (Herziene Statenvertaling).

Het stukje ‘style’ is niet standaard in Home Assistant, daarvoor heb je het volgende nodig: https://github.com/thomasloven/lovelace-card-mod

5. Resultaat.