Mit Daten arbeiten

Beginnen Sie mit den Maschinen, ermitteln Sie deren Sensoren und wählen Sie die Daten aus, die Ihre Integration benötigt.

Maschinen und Sensoren ermitteln#

Rufen Sie GET /api/v1/machines auf, um verfügbare Maschinen zu finden. Die optionalen Filter search und status grenzen die Ergebnisse ein.
Verwenden Sie GET /api/v1/machines/{id}/sensors, um Sensorkennungen und Metadaten zu ermitteln.
Rufen Sie GET /api/v1/machines/{id}/snapshot auf, um die neuesten verfügbaren Sensorwerte zu erhalten. Der optionale Zeitstempel at fordert eine Momentaufnahme um einen bestimmten Zeitpunkt an.

Verwenden Sie in nachfolgenden Anfragen die von der API zurückgegebenen Kennungen statt der Anzeigenamen.

Historische Messwerte abfragen#

Rufen Sie den Zeitreihenendpunkt mit einer bis acht Sensorkennungen auf. Wiederholen Sie sensor_id für mehrere Sensoren. Ersetzen Sie die Beispielkennungen und -daten durch Ihre eigenen.

curl --get 'https://connect-api.iris-cloud.netzsch.com/api/v1/machines/MACHINE_ID/timeseries' \
  --header "Authorization: Bearer $CONNECT_API_TOKEN" \
  --data-urlencode 'sensor_id=SENSOR_ID' \
  --data-urlencode 'from=2026-09-01T00:00:00Z' \
  --data-urlencode 'to=2026-09-02T00:00:00Z' \
  --data-urlencode 'interval=60000' \
  --data-urlencode 'aggregation=avg' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=100'

Zeitstempel: Verwenden Sie UTC-Zeitstempel nach RFC 3339, zum Beispiel 2026-09-01T00:00:00Z.
Zeitraum: maximal 30 Tage pro Abfrage; standardmäßig werden die letzten sieben Tage verwendet.
Intervall: eine positive Intervallgröße in Millisekunden; 60000 entspricht einer Minute.
Aggregation: avg, min, max, first oder last. Erfordert interval. Mit interval allein liefern die Intervalle min, max und avg.

Numerische Aggregation erfordert kompatible Sensorwerte. Die Referenz beschreibt das genaue Antwortformat.

Paginierte Ergebnisse lesen#

Die Endpunkte für Zeitreihen und Chargenlisten akzeptieren page und limit. Seiten beginnen bei 1; die Standardseitengröße beträgt 10, das Maximum 1000.

Lesen Sie die Paginierungsmetadaten der Antwort und fordern Sie weitere Seiten an, bis alle benötigten Ergebnisse vorliegen. Die Paginierung ist endpunktspezifisch; fügen Sie diese Parameter nur Endpunkten hinzu, die sie dokumentieren.

Alarme und Warnmeldungen verstehen#

Alarme stammen von der SPS der Maschine. Warnmeldungen werden von der Plattform für Maschinen und Sensoren erzeugt. Beide Endpunkte akzeptieren from und to, verwenden standardmäßig die letzten sieben Tage und unterstützen einen maximalen Zeitraum von 30 Tagen.

Produktionschargen abrufen#

Verwenden Sie GET /api/v1/batches, um Chargen aufzulisten. Filtern Sie nach status, sortieren Sie nach start_time, end_time, batch_id oder recipe und wählen Sie die Reihenfolge ASC oder DESC.

Verwenden Sie eine ID aus der Liste mit GET /api/v1/batches/{id}, um Details abzurufen. Alle unterstützten Statuswerte und Antwortfelder sind in der API-Referenz aufgeführt.

WEITERLESENFehler und Fehlerbehebung