Consolidated

Descrição#

Retorna os estados das máquinas, semelhante ao summary, mas consolidados - agrupados por valor (value) e com o tempo decorrido somado (value_elapsed_time).

Exemplo:

[
    {
        "serial": "ABCDEF12",
        "timestamp": "2021-03-04T00:00:00.000Z",
        "tag_id": "990",
        "tag": "Alarm",
        "value": "",
        "value_elapsed_time": 3600
    },
    {
        "serial": "ABCDEF12",
        "timestamp": "2021-03-04T00:00:00.000Z",
        "tag_id": "500",
        "tag": "Feedrate Override (%)",
        "value": "100.000000",
        "value_elapsed_time": 3600
    },
    {
        "serial": "ABCDEF12",
        "timestamp": "2021-03-04T00:00:00.000Z",
        "tag_id": "320",
        "tag": "Spindle Override (%)",
        "value": "100.000000",
        "value_elapsed_time": 3600
    },
]

URL#

URL autenticada
URL direta

/api/v1/:userKey/:apiKey/consolidated[?:params]

Parâmetros possíveis#

Parâmetro	Descrição	Exemplo	Obrigatório?
serial	Filtra o resultado para exibir apenas as máquinas desejadas. Pode receber uma ou mais máquinas. Separar os seriais usando vírgula (",")	serial=ABCDFE33,IJKLKM12	Não
start_time	Define a data/hora inicial dos dados no formato ISO 8601 (UTC). Deve acompanhar o parâmetro end_time	start_time=2021-03-01T08:00:00Z	Sim
end_time	Define a data/hora final dos dados no formato ISO 8601 (UTC). Deve acompanhar o parâmetro start_time	end_time=2021-03-01T09:00:00Z	Sim
tagid	Filtra apenas os resultados onde a chave tag_id for igual ao valor informado. Pode informar uma ou mais tags. Deve-se separar várias tags usando-se vírgula. Consulta a rota Reference Table para detalhes	tagid=99,700	Não
<TYPE>	Define o tipo de consolidado que se deseja obter. Veja mais em Tipos de dados consolidados		Sim

Modificadores de data/hora#

Você pode substituir os parâmetros start_time/end_time por um modificador de data/hora (clique aqui para saber mais). Caso ambos estejam presentes, o primeiro par tem preferência.

Tipos de dados consolidados#

Há 4 tipos de dados consolidados:

hourly: Dados consolidados por hora
daily: Dados consolidados por dia
weekly: Dados consolidados por semana
monthly: Dados consolidados por mês

Utilize um desses modificadores para consultar os dados.

Exemplo de consulta#

// buscando os dados consolidados de todas as máquinas entre 08h00 e 09h00 (UTC) do dia 03/01/2021
/consolidated?start_time=2021-03-01T08:00:00Z&end_time=2021-03-01T09:00:00Z&hourly

// Filtrando os resultados da consulta anterior para somente uma máquina
/consolidated?consolidated=2021-03-01T08:00:00Z&end_time=2021-03-01T09:00:00Z&serial=ABCDE12&hourly

// Filtrando os resultados da consulta anterior para somente duas máquinas
/consolidated?start_time=2021-03-01T08:00:00Z&end_time=2021-03-01T09:00:00Z&serial=ABCDE12,HGHRR12&hourly

// Usando um modificador de data/hora para consultar tudo do dia corrente
/consolidated?today&serial=ABCDE12,HGHRR12&hourly