Leer datos de una señal
Scope requerido: signals.read.
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 7 días, y una consulta no puede producir más de 12,000 puntos. Los valores por defecto (agg_unit=s, agg_period=1) alcanzan el límite de puntos en menos de tres horas y media, así que la mayoría de las llamadas los fijan explícitamente.
Parámetros de ruta
El uuid de la máquina, tal como lo devuelve GET /v1/machines.
uuidEl ID público.
uuidParámetros de consulta
Filtra por hora de inicio.
date-timeFiltra por hora de fin.
date-timeFiltra por unidad de agregación.
"s"Valor en
- "s"
- "m"
- "h"
- "d"
Filtra por periodo de agregación.
1 <= value1Filtra por función de agregación.
"avg"Valor en
- "avg"
- "max"
- "min"
- "sum"
- "count"
Devuelve los arreglos paralelos timestamps y values en lugar de una lista de puntos {timestamp, value}.
falseCuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/machines/497f6eca-6276-4993-bfeb-53cbbbba6f08/signals/497f6eca-6276-4993-bfeb-53cbbbba6f08?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z"{ "machine_uuid": "01748f7c-9688-7abc-8def-0123456789ab", "public_id": "eb3ce6c7-ce7e-4638-a072-e5054706f601", "name": "string", "agg_unit": "s", "agg_period": 0, "agg_function": "avg", "data": [ { "timestamp": "2019-08-24T14:15:22Z", "value": 0 } ]}Listar las señales de una máquina GET
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.
Crear órdenes de trabajo POST
Crea una o varias órdenes de trabajo. El cuerpo es un arreglo JSON, incluso para un solo registro. La creación es idempotente por nombre: los nombres se recortan y se eliminan los duplicados, una orden de trabajo que ya existe se devuelve tal cual, y una que se eliminó se restaura en lugar de duplicarse.