Leer datos de una señal
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.
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
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 SKUs POST
Crea uno o varios SKUs. El cuerpo es un **arreglo** JSON, incluso para un solo registro. Solo `sku` (el código de producto) es obligatorio; `unit` vale `units` por defecto y `archived` vale `false`.