Öffentliche API

Mit der öffentlichen Smart-TB-Tech API kannst du ausgewählte VyraVolt-Werte schreibgeschützt auf Webseiten, Dashboards oder in eigene Anwendungen einbinden. Veröffentlicht werden ausschließlich die Werte, die im persönlichen API-Link ausdrücklich freigegeben wurden.

Endpunkt

GET https://d2gwkxhdhe9hzz.cloudfront.net/v1/{publicLinkId}/values.json

Der Aufruf benötigt keine Anmeldung und ist ausschließlich lesend. Der individuelle Link muss deshalb wie ein öffentliches Zugriffstoken behandelt und nur dort eingebunden werden, wo die freigegebenen Daten sichtbar sein dürfen.

Antwortformat

Die API liefert ein JSON-Dokument mit diesen zentralen Feldern:

Jeder Eintrag in values besitzt eine stabile id sowie – sofern verfügbar – label, value, unit, daily, trend, stale und error. Verbraucher sollten Einträge über id zuordnen und fehlende optionale Felder sauber behandeln.

JavaScript-Beispiel

const endpoint =
  "https://d2gwkxhdhe9hzz.cloudfront.net/v1/DEINE_PUBLIC_LINK_ID/values.json";

const response = await fetch(endpoint, { cache: "no-store" });
if (!response.ok) {
  throw new Error(`API antwortet mit ${response.status}`);
}

const document = await response.json();
const valuesById = new Map(
  document.values.map((item) => [item.id, item]),
);

console.log(document.updatedAt, valuesById);

Nutze dataIntervalSec als Mindesttakt für die automatische Aktualisierung. Dadurch bleibt die Einbindung cachefreundlich und ruft nicht häufiger ab, als neue Daten bereitgestellt werden.

Sicher und robust einbinden

• nur ausdrücklich freigegebene Werte veröffentlichen
• auf stale, error und fehlende Werte reagieren
• Einträge über die stabile id statt ausschließlich über sichtbare Namen zuordnen
• Einheiten aus unit übernehmen und nicht fest annehmen
• den API-Link nicht als Schreib- oder Gerätesteuerungszugang verwenden

VyraPulse Live – Demoseite mit echten Standortdaten

VyraPulse Live ist eine reine Demonstrationsseite von Smart TB Tech. Sie visualisiert echte, über die öffentliche API freigegebene Daten des Smart-TB-Tech-Firmenstandorts und zeigt beispielhaft, welche individuellen Websites, Dashboards oder Anwendungen auf Basis eines eigenen API-Links entwickelt werden können.

Das Freischalten eines API-Links stellt ausschließlich den schreibgeschützten JSON-Datenzugang bereit. Dadurch erhält der Nutzer weder automatisch eine VyraPulse-Seite noch ein fertiges Dashboard oder eine individuell erstellte Website. Gestaltung, Entwicklung, Hosting und Einbindung einer eigenen Darstellung müssen separat umgesetzt werden.

VyraPulse Live öffnen

Die Demoseite zeigt unter anderem Wetterlage, Haus-Netz-Messpunkt, Wind, Pool- und Sensordaten des Firmenstandorts. Sie dient ausschließlich als Anschauungsbeispiel für die Möglichkeiten der öffentlichen API.