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

machine_uuid*Machine Uuid

O uuid da máquina, tal como devolvido por GET /v1/machines.

Formatouuid
public_id*Public Id

O ID público.

Formatouuid

Parâmetros de consulta

start_time*Start Time

Filtra pela hora de início.

Formatodate-time
end_time*End Time

Filtra pela hora de fim.

Formatodate-time
agg_unit?AggregationUnit

Filtra pela unidade de agregação.

Predefinição"s"

Valor em

  • "s"
  • "m"
  • "h"
  • "d"
agg_period?Agg Period

Filtra pelo período de agregação.

Intervalo1 <= value
Predefinição1
agg_function?AggregationFunction

Filtra pela função de agregação.

Predefinição"avg"

Valor em

  • "avg"
  • "max"
  • "min"
  • "sum"
  • "count"
transpose?Transpose

Devolve os arrays paralelos timestamps e values em vez de uma lista de pontos {timestamp, value}.

Predefiniçãofalse

Corpo da resposta

application/json

application/json

Experimente em direto
GET
/v1/machines/{machine_uuid}/signals/{public_id}

Este endpoint requer autenticação. Cole um token na secção Autorização, mais abaixo.

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    }  ]}