Process data API

Use this API and its MCP server to read and export process data. To send process data, see Sending process data. For authentication, tenants and general conventions, see Concepts.

All endpoints with their parameters and data structures: Process data API reference.

REST API

Base URL:

https://<sot-host>/pqm/api/v1/tenants/{tenantId}

Path Method Purpose Permission

Path	Method	Purpose	Permission
`/machine-data/devices/{deviceId}/processes`	`GET`	Process results of a device. Default time range: last 14 days.	`processes:read`
`/machine-data/devices/{deviceId}/processes/partids`	`GET`	Part IDs of a device, for auto-completion	`processes:read`
`/machine-data/devices/{deviceId}/processes/parttypeids`	`GET`	Part type IDs of a device, for auto-completion	`processes:read`
`/machine-data/devices/{deviceId}/processes/programs`	`GET`	Programs of a device, for auto-completion	`processes:read`
`/chart-data/devices/{deviceId}/processes/search`	`POST`	Curves of selected processes, optionally with X and Y axes (measuring point IDs)	`processes:read`
`/export/devices/{deviceId}/processes`	`GET`	Export process data as `csv` or `json` (complete OPP messages). Filters: time range, result, program, part ID, part type.	`processes:export`

/machine-data/devices/{deviceId}/processes

GET

Process results of a device. Default time range: last 14 days.

processes:read

/machine-data/devices/{deviceId}/processes/partids

GET

Part IDs of a device, for auto-completion

processes:read

/machine-data/devices/{deviceId}/processes/parttypeids

GET

Part type IDs of a device, for auto-completion

processes:read

/machine-data/devices/{deviceId}/processes/programs

GET

Programs of a device, for auto-completion

processes:read

/chart-data/devices/{deviceId}/processes/search

POST

Curves of selected processes, optionally with X and Y axes (measuring point IDs)

processes:read

/export/devices/{deviceId}/processes

GET

Export process data as csv or json (complete OPP messages). Filters: time range, result, program, part ID, part type.

processes:export

{deviceId} is the ID of the device (UUID), not the technical ID. See Master data API.

Errors

{
  "code": 400,
  "message": "human-readable message"
}

MCP server

https://<sot-host>/pqm/tenants/{tenantId}/mcp

All tools only read data.

Tool Purpose

Tool	Purpose
`sot-pqm_query_devices`	Devices with process data and their latest result; 20 per page, at most 100
`sot-pqm_query_process_results`	Process results of a device without curves; latest 20 by default
`sot-pqm_query_process_curves`	Curve of one part, in pages of 20 points
`sot-pqm_query_process_curve_comparison`	Curves of two or more parts for comparison, in pages of 20 points
`sot-pqm_query_special_values`	Special values of process data
`sot-pqm_query_deviations`	NOK processes and the number of OK and NOK processes; 20 per page, at most 100

sot-pqm_query_devices

Devices with process data and their latest result; 20 per page, at most 100

sot-pqm_query_process_results

Process results of a device without curves; latest 20 by default

sot-pqm_query_process_curves

Curve of one part, in pages of 20 points

sot-pqm_query_process_curve_comparison

Curves of two or more parts for comparison, in pages of 20 points

sot-pqm_query_special_values

Special values of process data

sot-pqm_query_deviations

NOK processes and the number of OK and NOK processes; 20 per page, at most 100

The MCP tools currently require the permission measuring_points:read. The REST API requires processes:read.

Prozessdaten-API

Diese API und ihr MCP-Server dienen zum Lesen und Exportieren von Prozessdaten. Prozessdaten senden: siehe Prozessdaten senden. Authentifizierung, Tenants und allgemeine Konventionen: siehe Konzepte.

Alle Endpunkte mit ihren Parametern und Datenstrukturen: Referenz der Prozessdaten-API.

REST-API

Basis-URL:

https://<sot-host>/pqm/api/v1/tenants/{tenantId}

Pfad Methode Zweck Berechtigung

Pfad	Methode	Zweck	Berechtigung
`/machine-data/devices/{deviceId}/processes`	`GET`	Prozessergebnisse eines Geräts. Standardzeitraum: letzte 14 Tage.	`processes:read`
`/machine-data/devices/{deviceId}/processes/partids`	`GET`	Teile-IDs eines Geräts, für die automatische Vervollständigung	`processes:read`
`/machine-data/devices/{deviceId}/processes/parttypeids`	`GET`	Teiletyp-IDs eines Geräts, für die automatische Vervollständigung	`processes:read`
`/machine-data/devices/{deviceId}/processes/programs`	`GET`	Programme eines Geräts, für die automatische Vervollständigung	`processes:read`
`/chart-data/devices/{deviceId}/processes/search`	`POST`	Kurven ausgewählter Prozesse, optional mit X- und Y-Achsen (IDs von Messpunkten)	`processes:read`
`/export/devices/{deviceId}/processes`	`GET`	Prozessdaten als `csv` oder `json` (vollständige OPP-Nachrichten) exportieren. Filter: Zeitraum, Ergebnis, Programm, Teile-ID, Teiletyp.	`processes:export`

/machine-data/devices/{deviceId}/processes

GET

Prozessergebnisse eines Geräts. Standardzeitraum: letzte 14 Tage.

processes:read

/machine-data/devices/{deviceId}/processes/partids

GET

Teile-IDs eines Geräts, für die automatische Vervollständigung

processes:read

/machine-data/devices/{deviceId}/processes/parttypeids

GET

Teiletyp-IDs eines Geräts, für die automatische Vervollständigung

processes:read

/machine-data/devices/{deviceId}/processes/programs

GET

Programme eines Geräts, für die automatische Vervollständigung

processes:read

/chart-data/devices/{deviceId}/processes/search

POST

Kurven ausgewählter Prozesse, optional mit X- und Y-Achsen (IDs von Messpunkten)

processes:read

/export/devices/{deviceId}/processes

GET

Prozessdaten als csv oder json (vollständige OPP-Nachrichten) exportieren. Filter: Zeitraum, Ergebnis, Programm, Teile-ID, Teiletyp.

processes:export

{deviceId} ist die ID des Geräts (UUID), nicht die technische ID. Siehe Stammdaten-API.

Fehler

{
  "code": 400,
  "message": "human-readable message"
}

MCP-Server

https://<sot-host>/pqm/tenants/{tenantId}/mcp

Alle Tools lesen ausschließlich Daten.

Tool Zweck

Tool	Zweck
`sot-pqm_query_devices`	Geräte mit Prozessdaten und ihr neuestes Ergebnis; 20 je Seite, höchstens 100
`sot-pqm_query_process_results`	Prozessergebnisse eines Geräts ohne Kurven; standardmäßig die neuesten 20
`sot-pqm_query_process_curves`	Kurve eines Teils, in Seiten zu 20 Punkten
`sot-pqm_query_process_curve_comparison`	Kurven von zwei oder mehr Teilen zum Vergleich, in Seiten zu 20 Punkten
`sot-pqm_query_special_values`	Sonderwerte von Prozessdaten
`sot-pqm_query_deviations`	NOK-Prozesse und die Anzahl der OK- und NOK-Prozesse; 20 je Seite, höchstens 100

sot-pqm_query_devices

Geräte mit Prozessdaten und ihr neuestes Ergebnis; 20 je Seite, höchstens 100

sot-pqm_query_process_results

Prozessergebnisse eines Geräts ohne Kurven; standardmäßig die neuesten 20

sot-pqm_query_process_curves

Kurve eines Teils, in Seiten zu 20 Punkten

sot-pqm_query_process_curve_comparison

Kurven von zwei oder mehr Teilen zum Vergleich, in Seiten zu 20 Punkten

sot-pqm_query_special_values

Sonderwerte von Prozessdaten

sot-pqm_query_deviations

NOK-Prozesse und die Anzahl der OK- und NOK-Prozesse; 20 je Seite, höchstens 100

Die MCP-Tools erfordern derzeit die Berechtigung measuring_points:read. Die REST-API erfordert processes:read.

Diese Seite bearbeiten Edit this page