Trabajar con datos

Empieza por las máquinas, descubre sus sensores y elige los datos que necesita tu integración.

Descubre máquinas y sensores#

Llama a GET /api/v1/machines para encontrar máquinas disponibles. Los filtros opcionales search y status limitan los resultados.
Usa GET /api/v1/machines/{id}/sensors para descubrir los IDs y metadatos de los sensores.
Llama a GET /api/v1/machines/{id}/snapshot para obtener los últimos valores disponibles de los sensores. El parámetro opcional at solicita una vista instantánea alrededor de un momento concreto.

En las siguientes solicitudes, usa los identificadores devueltos por la API en lugar de los nombres visibles.

Consulta mediciones históricas#

Llama al endpoint de series temporales con entre uno y ocho IDs de sensores. Repite sensor_id para varios sensores. Sustituye los IDs y las fechas del ejemplo por los tuyos.

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'

Fechas y horas: usa el formato RFC 3339 en UTC, como 2026-09-01T00:00:00Z.
Período: un máximo de 30 días por consulta; el valor predeterminado son los últimos siete días.
Intervalo: tamaño positivo del intervalo de agregación en milisegundos; 60000 equivale a un minuto.
Agregación: avg, min, max, first o last. Requiere interval. Con solo interval, los intervalos devuelven min, max y avg.

La agregación numérica requiere valores de sensores compatibles. La referencia describe el formato exacto de la respuesta.

Lee resultados paginados#

Los endpoints de series temporales y listas de lotes aceptan page y limit. Las páginas empiezan en 1; el tamaño predeterminado es 10 y el máximo es 1000.

Lee los metadatos de paginación de la respuesta y solicita la siguiente página hasta obtener todos los resultados que necesites. La paginación depende del endpoint; no añadas estos parámetros a endpoints que no los documenten.

Comprende las alarmas y alertas#

Las alarmas provienen del PLC de la máquina. Las alertas las genera la plataforma para máquinas y sensores. Ambos endpoints aceptan from y to, usan los últimos siete días de forma predeterminada y permiten un período máximo de 30 días.

Consulta lotes de producción#

Usa GET /api/v1/batches para listar lotes. Filtra por status, ordena por start_time, end_time, batch_id o recipe y elige el orden ASC o DESC.

Usa un ID de la lista en GET /api/v1/batches/{id} para consultar los detalles. Todos los valores de estado y campos de respuesta admitidos aparecen en la referencia de la API.

SIGUE LEYENDOErrores y solución de problemas