> For the complete documentation index, see [llms.txt](https://mrwheel-docs.gitbook.io/dsmrlogger32/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mrwheel-docs.gitbook.io/dsmrlogger32/beschrijving-restapis-v2/dsmr-logger-gerelateerde-restapis.md).

# DSMR-logger gerelateerde restAPI's

## informatie over de DSMR-logger

<mark style="color:blue;">`GET`</mark> `http://dsmr-esp32.local/api/v2/dev/info`

Deze restAPI geeft informatie terug van de DSMR-logger

{% tabs %}
{% tab title="200 Succes" %}

```
{
  "devinfo": {
    "author": "Willem Aandewiel (www.aandewiel.nl)",
    "fwversion": "v5.0.2 (22-12-2022)",
    "compiled": "Dec 24 2022 10:42:31",
    "hostname": "DSMR-ESP32",
    "ipaddress": "192.168.12.143",
    "macaddress": "8C:4B:14:81:FF:B0",
    "indexfile": "DSMRindex.html",
    "free_heap": 229604,
    "min_free_heap": 4087619,
    "psram_size": 4191755,
    "free_psram_size": 4057915,
    "used_psram_size": 133840,
    "chip_model": "ESP32-D0WDQ5",
    "sdk_version": "v4.4.2",
    "cpu_freq": 240,
    "sketch_size": 1207712,
    "free_sketch_space": 1310720,
    "filesysSetting_size": 1378241,
    "flashchip_speed": 80000000,
    "flashchip_mode": "DIO",
    "filesystem_type": "SPIFFS",
    "compile_options": "",
    "ssid": "AandeWiFi",
    "wifi_rssi": -47,
    "time": "02-01-2023 13:09:13",
    "uptime": "3(d)-02:06(H:m)",
    "uptime_sec": 266770,
    "daily_reboot": 0,
    "oled_type": 2,
    "oled_flip_screen": 1,
    "neo_brightness": 30,
    "smhasfaseinfo": 1,
    "telegram_interval": 10,
    "telegram_count": 31513,
    "telegram_errors": 0,
    "mqtt_broker": "192.168.12.250:1883",
    "mqtt_interval": 60,
    "mqtt_broker_connected": "yes",
    "reboots": 2,
    "last_reset": "[3] Software reset digital core (ESP.restart())"
  }
}
```

{% endtab %}
{% endtabs %}

## Systeem Tijd

<mark style="color:blue;">`GET`</mark> `http://dsmr-esp32.local/api/v2/dev/time`

Deze restAPI geeft de systeem tijd van de DSMR-logger

{% tabs %}
{% tab title="200 Succes" %}

```
{
  "devtime": {
    "timestamp": "230102130942W",
    "time": "02-01-2023 13:09:49",
    "time_rev": "2023-01-0002 13:09:",
    "epoch": 1672661389,
    "uptime": "3(d)-02:06(H:m)",
    "uptime_secs": 266808
  }
}
```

{% endtab %}
{% endtabs %}

## Instellingen

<mark style="color:blue;">`GET`</mark> `http://dsmr-esp32.local/api/v2/dev/settings`

Deze restAPI geeft alle, door de gebruiker muteerbare, Slimme Meter settingen terug

{% tabs %}
{% tab title="200 Succes" %}

```
{
  "system": [
    {
      "name": "hostname", "value": "DSMR-ESP32", "type": "s", "maxlen": 29
    },
    {
      "name": "index_page", "value": "DSMRindex.html", "type": "s", "maxlen": 49
    },
    {
      "name": "daily_reboot", "value": 0, "type": "i", "min": 1, "max": 1
    },
    {
      "name": "no_hour_slots", "value": 121, "type": "i", "min": 49, "max": 190
    },
    {
      "name": "no_day_slots", "value": 32, "type": "i", "min": 15, "max": 155
    },
    {
      "name": "no_month_slots", "value": 2, "type": "i", "min": 2, "max": 5
    },
    {
      "name": "alter_ring_slots", "value": 0, "type": "i", "min": 0, "max": 1
    },
    {
      "name": "tlgrm_interval", "value": 5, "type": "i", "min": 2, "max": 60
    },
    {
      "name": "oled_type", "value": 2, "type": "i", "min": 0, "max": 2
    },
    {
      "name": "oled_screen_time", "value": 3, "type": "i", "min": 0, "max": 300
    },
    {
      "name": "oled_flip_screen", "value": 1, "type": "i", "min": 0, "max": 1
    },
    {
      "name": "neo_brightness", "value": 75, "type": "i", "min": 10, "max": 250
    },
    {
      "name": "mqtt_broker", "value": "192.168.12.250", "type": "s", "maxlen": 100
    },
    {
      "name": "mqtt_broker_port", "value": 1883, "type": "1", "min": 1, "max": 9999
    },
    {
      "name": "mqtt_user", "value": "", "type": "s", "maxlen": 39
    },
    {
      "name": "mqtt_passwd", "value": "", "type": "s", "maxlen": 39
    },
    {
      "name": "mqtt_toptopic", "value": "DSMR-DEV32", "type": "s", "maxlen": 20
    },
    {
      "name": "mqtt_interval", "value": 10, "type": "i", "min": 0, "max": 600
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Instellingen aanpassen

<mark style="color:green;">`POST`</mark> `http://dsmr-esp32.local/api/v2/settings/{"name":"<settingVeld>","value":"<nieuweWaarde>"}`

{% tabs %}
{% tab title="200 " %}

```
{"name":"<settingVeld>","value":"<nieuweWaarde>"}
```

{% endtab %}
{% endtabs %}

## Hieronder een opsomming van de settingsVelden:

### hostname

* type: String
* maxlen: 29
* Opmerking:
  * Characters

### ed\_tariff1 (Geleverde Energy, tarief 1)

* type: float
* min: 0
* max: 10
* decimalen: 5

### ed\_tariff2 (Geleverde Energy, tarief 2)

* type: float
* min: 0
* max: 10
* Decimalen: 5

### er\_tariff1 (Opgewekte Energy, tarief 1)

* type: float
* min: 0
* max: 10
* Decimalen: 5

### er\_tariff2 (Opgewekte Energy, tarief 2)

* type: float
* min: 0
* max: 10
* Decimalen: 5

### gd\_tariff (Gas Geleverd)

* type: float
* min: 0
* max: 10
* Decimalen: 5

### electr\_netw\_costs (Netwerk kosten Electra)

* type: float
* min: 0
* max: 100
* Decimalen: 2
* Opmerking:
  * Euro's per maand

### gas\_netw\_costs (Netwerk kosten Gas)

* type: float
* min: 0
* max: 100
* Decimalen: 2
* Opmerking:
  * Euro's per maand

### tlgrm\_interval (telegram Interval)

* type: Integer
* min: 1
* max: 60
* Opmerking:
  * Seconden

### index\_page (alternatieve index.html pagina)

* type: String
* maxlen: 49
* Opmerking:
  * Characters
  * Default: `DSMRindex.html`

### mqtt\_broker (URL of IP-adres)

* type: String
* maxlen: 100
* Opmerking:
  * Characters

### mqtt\_broker\_port

* type: Integer
* min: 0
* max: 9999

### mqtt\_user

* type: String
* maxlen: 39
* Opmerking:
  * Characters

### mqtt\_passwd

* type: String
* maxlen: 29
* Opmerking:
  * Characters

### mqtt\_toptopic

* type: String
* maxlen: 20
* Opmerking:
  * Characters

### mqtt\_interval (interval voor het versturen van MQTT berichten)

* type: Integer
* min: 0
* max: 600
* Opmerking: Seconden
  * indien '0' worden er géén berichten verstuurd
  * er wordt nooit vaker een bericht verstuurd dan `tlgrm_interval`