Listar las señales de una máquina
Devuelve las señales de sensor en crudo que expone una máquina, con el public_id necesario para leer sus muestras.
Una señal es un canal de sensor que lee la máquina, nombrado según la magnitud física que transporta (current, count, product_count, cycle, energy, temperature, pressure, ...). Una máquina puede exponer varias señales con el mismo name; su display_name las distingue. No se listan las señales eliminadas ni las que no tienen un tipo.
description viene en inglés por defecto; pasa language=es para obtenerla en español. Una descripción sin traducción al idioma pedido se devuelve en inglés.
Parámetros de ruta
El uuid de la máquina, tal como lo devuelve GET /v1/machines.
uuidParámetros de consulta
Idioma de la description de cada señal. Si no hay traducción, se usa inglés.
"en"Valor en
- "en"
- "es"
Cuerpo de la respuesta
application/json
application/json
curl -X GET "https://example.com/v1/machines/497f6eca-6276-4993-bfeb-53cbbbba6f08/signals"{ "machine_uuid": "01748f7c-9688-7abc-8def-0123456789ab", "signals": [ { "public_id": "eb3ce6c7-ce7e-4638-a072-e5054706f601", "name": "string", "display_name": "string", "description": "string" } ]}Reporte de paros POST
Devuelve los paros individuales de las máquinas con su duración, causa y clasificación. Es el detalle detrás de los totales de tiempo muerto del reporte de métricas. `stopId` acepta la gramática de comparación completa, así que se puede obtener directamente un paro específico o un rango de ellos.
Leer datos de una señal GET
Devuelve los puntos agregados de una señal de sensor en crudo. Las muestras se agrupan en intervalos antes de devolverse. El ancho de cada intervalo es `agg_period` x `agg_unit` (`agg_period=15`, `agg_unit=m` es un intervalo de 15 minutos) y `agg_function` define cómo se reducen las muestras dentro de un intervalo. Por defecto los puntos se devuelven como una lista `data` de objetos `{timestamp, value}`. Pasa `transpose=true` para recibir en su lugar dos arreglos de la misma longitud, `timestamps` y `values`, donde `values[i]` corresponde a `timestamps[i]`. Contiene los mismos puntos en una respuesta más pequeña. Se aplican dos límites, y ambos rechazan la solicitud en lugar de recortar la respuesta: la ventana entre `start_time` y `end_time` no puede superar **14 días**, y una consulta no puede producir más de **10,000 puntos**. Los valores por defecto (`agg_unit=s`, `agg_period=1`) alcanzan el límite de puntos en menos de tres horas, así que la mayoría de las llamadas los fijan explícitamente.