Archivi degli eventi

GET /api/v1/channel_data

Restituisce l’archivio degli eventi di un dispositivo di misura. Utilizza lo stesso endpoint channel_data delle letture, ma con un archive_type di tipo evento; la risposta contiene record di eventi/messaggi (codici e descrizioni) anziché canali numerici.

Parametri di query

archive_type string obbligatorio

Tipo di archivio degli eventi. Uno tra: nesht, nesht_svod, changes, event, alarm, valve, seance.

equipment_id integer obbligatorio

Identificatore del dispositivo di misura. In alternativa è possibile passare la coppia energy_varname + uid.

fp_start string

Intervallo temporale (inizio del periodo) nel formato yyyy-mm-dd. Facoltativo.

fp_end string

Intervallo temporale (fine del periodo) nel formato yyyy-mm-dd. Facoltativo.

page integer

Numero di pagina.

per_page integer

Dimensione della pagina. Facoltativo. Per gli archivi degli eventi il valore predefinito è 10.

Campi della risposta

Attributo	Descrizione
`data[].event_time`	Unix time dell’evento (in secondi; i millisecondi sono aggiunti come parte frazionaria)
`data[].channel_data`	Array di oggetti a chiave singola `{ varname: value }`. I campi `*Description` sono arricchiti con i testi dell’elenco di riferimento dei messaggi
`total_pages`	Numero totale di pagine nell’insieme restituito
`current_page`	Pagina corrente
`next_page`	Pagina successiva disponibile per il caricamento, `null` se la pagina corrente è l’ultima

Richiesta

bash

curl -i \
  --header "access-token: *********************" \
  --header "token-type: Bearer" \
  --header "client: **********************" \
  --header "uid: api-user@example.com" \
  --header "Content-Type: application/json" \
  --request GET \
  "https://api.vadsro.eu/api/v1/channel_data?archive_type=nesht&equipment_id=906&fp_start=2025-05-01&fp_end=2026-05-29&page=1"

const res = await fetch(
  'https://api.vadsro.eu/api/v1/channel_data?archive_type=nesht&equipment_id=906&fp_start=2025-05-01&fp_end=2026-05-29&page=1',
  {
    headers: {
      'access-token': '*********************',
      'token-type': 'Bearer',
      client: '**********************',
      uid: 'api-user@example.com',
      'Content-Type': 'application/json',
    },
  },
);
const data = await res.json();

python

import requests

res = requests.get(
    "https://api.vadsro.eu/api/v1/channel_data",
    params={
        "archive_type": "nesht",
        "equipment_id": 906,
        "fp_start": "2025-05-01",
        "fp_end": "2026-05-29",
        "page": 1,
    },
    headers={
        "access-token": "*********************",
        "token-type": "Bearer",
        "client": "**********************",
        "uid": "api-user@example.com",
        "Content-Type": "application/json",
    },
)
data = res.json()

req, _ := http.NewRequest("GET", "https://api.vadsro.eu/api/v1/channel_data?archive_type=nesht&equipment_id=906&fp_start=2025-05-01&fp_end=2026-05-29&page=1", nil)
req.Header.Set("access-token", "*********************")
req.Header.Set("token-type", "Bearer")
req.Header.Set("client", "**********************")
req.Header.Set("uid", "api-user@example.com")
req.Header.Set("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

php

$ch = curl_init("https://api.vadsro.eu/api/v1/channel_data?archive_type=nesht&equipment_id=906&fp_start=2025-05-01&fp_end=2026-05-29&page=1");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "access-token: *********************",
    "token-type: Bearer",
    "client: **********************",
    "uid: api-user@example.com",
    "Content-Type: application/json",
]);
$data = json_decode(curl_exec($ch), true);

Risposta

json

{
  "data": [
    {
      "event_time": 1748476800.123,
      "channel_data": [
        { "Code": "1" },
        { "CodeDescription": "Emergency situation: connection loss" },
        { "ValCode": "23.6" },
        { "Izm": "0" }
      ]
    }
  ],
  "total_pages": 5,
  "current_page": 1,
  "next_page": 2
}

Ultimo aggiornamento il 8 agosto 2026

Questa pagina è stata utile?