macOS HTTP-Server

Auf dem Mac kann DataJot einen lokalen HTTP-Server für Skripte und externe Werkzeuge bereitstellen. Diese Funktion ist optional und keine Cloud-API.

Server aktivieren

1. Öffnen Sie die DataJot Einstellungen unter macOS.
2. Aktivieren Sie den HTTP-Server.
3. Verwenden Sie nur lokalen Zugriff, wenn die Anfragen von diesem Mac stammen.
4. Aktivieren Sie den Zugriff im lokalen Netzwerk nur, wenn ein anderes Gerät den Server erreichen muss.
5. Prüfen Sie den Dienst mit GET /health.

Die lokale Standardadresse lautet:

http://127.0.0.1:17654

Bei aktiviertem Netzwerkzugriff wird derselbe Port über die lokale IPv4-Adresse des Mac bereitgestellt.

Sicherheit: Der Server verwendet keine Authentifizierung. Der Zugriff im lokalen Netzwerk macht den Dienst daher für Geräte in diesem Netzwerk erreichbar. Verwenden Sie ihn nur in einem geeigneten Netzwerk und deaktivieren Sie ihn, wenn er nicht benötigt wird.

Verfügbare Endpunkte

GET  /
GET  /health
GET  /series
POST /measures
GET  /measures

Die früheren Endpunkte POST /series/{uuid-or-name}/values und POST /series/{uuid-or-name}/measures sollten nicht mehr verwendet werden.

Serie identifizieren

Eine Anfrage muss entweder seriesId oder seriesName enthalten, aber nicht beides.

seriesId bleibt beim Umbenennen der Serie stabil. seriesName ist lesbarer, wird jedoch mehrdeutig, wenn mehrere Serien ohne Berücksichtigung der Groß- und Kleinschreibung denselben Namen tragen.

Messwert hinzufügen

curl -X POST http://127.0.0.1:17654/measures \
  -H 'Content-Type: application/json' \
  -d '{"seriesName":"Gewicht","value":72.4}'

Wenn das Datum fehlt, verwendet DataJot das aktuelle Datum. Verwenden Sie für mehrere Messwerte values, ein Array aus Objekten mit jeweils value und optional date, statt value.

Die Antwort enthält die Anzahl der erstellten Einträge und die Zielserie. Prüfen Sie bei der ersten Integration anschließend die Messwertliste in DataJot.

Messwerte lesen

GET /measures benötigt eine Serie und eine Granularität. Verfügbare Granularitäten sind raw, hour, day, week und month.

Rohwerte sind nach Datum absteigend sortiert und unterstützen Cursor-Paginierung. Aggregierte Antworten sind nach dem Beginn des Zeitraums aufsteigend sortiert.

Anfragegenerator

Der macOS HTTP Measure Request Builder erstellt eine Anfrage an POST /measures, ohne dass Sie JSON manuell schreiben müssen:

1. Wählen Sie eine Serie und geben Sie einen Wert ein.
2. Fügen Sie bei Bedarf ein Datum hinzu.
3. Kopieren Sie das erzeugte JSON oder den curl-Befehl.
4. Führen Sie die Anfrage mit Ihrem lokalen Werkzeug aus.

Der Generator benötigt eine vorhandene Serie und erstellt keine Leseanfragen.