Ler dados de um sinal
Devolve os pontos agregados de um sinal de sensor em bruto.
As amostras são agrupadas em intervalos antes de serem devolvidas. A largura de cada intervalo é agg_period x agg_unit (agg_period=15, agg_unit=m é um intervalo de 15 minutos) e agg_function define como são reduzidas as amostras dentro de um intervalo.
Por predefinição, os pontos são devolvidos como uma lista data de objetos {timestamp, value}. Passe transpose=true para receber, em vez disso, dois arrays do mesmo comprimento, timestamps e values, em que values[i] corresponde a timestamps[i]. Contém os mesmos pontos numa resposta mais pequena.
Aplicam-se dois limites, e ambos rejeitam o pedido em vez de truncar a resposta: a janela entre start_time e end_time não pode exceder 7 dias, e uma consulta não pode produzir mais de 12 000 pontos. Os valores predefinidos (agg_unit=s, agg_period=1) atingem o limite de pontos em menos de três horas e meia, por isso a maioria das chamadas define-os explicitamente.
Parâmetros de caminho
O uuid da máquina, tal como devolvido por GET /v1/machines.
uuidO ID público.
uuidParâmetros de consulta
Filtra pela hora de início.
date-timeFiltra pela hora de fim.
date-timeFiltra pela unidade de agregação.
"s"Valor em
- "s"
- "m"
- "h"
- "d"
Filtra pelo período de agregação.
1 <= value1Filtra pela função de agregação.
"avg"Valor em
- "avg"
- "max"
- "min"
- "sum"
- "count"
Devolve os arrays paralelos timestamps e values em vez de uma lista de pontos {timestamp, value}.
falseCorpo da resposta
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 os sinais de uma máquina GET
Devolve os sinais de sensor em bruto que uma máquina expõe, com o `public_id` necessário para ler as suas amostras. Um sinal é um canal de sensor lido pela máquina, com o nome da grandeza física que transporta (`current`, `count`, `product_count`, `cycle`, `energy`, `temperature`, `pressure`, ...). Uma máquina pode expor vários sinais com o mesmo `name`; o seu `display_name` distingue-os. Os sinais eliminados e os que não têm um tipo não são listados. `description` vem em inglês por predefinição; passe `language=es` para a obter em espanhol. Uma descrição sem tradução no idioma pedido é devolvida em inglês.
Criar ordens de trabalho POST
Cria uma ou várias ordens de trabalho. O corpo é um **array** JSON, mesmo para um único registo. A criação é idempotente por nome: os espaços nas extremidades dos nomes são removidos e os duplicados são eliminados, uma ordem de trabalho que já existe é devolvida tal como está, e uma que foi eliminada é restaurada em vez de duplicada.