Consulta de medidores

Mediante esta API se consulta o listado dos medidores criados no Fracttal.
Esta API te permite filtrar para obter apenas os medidores que você precisa: pelo código do ativo e/ou pelo serial do medidor.

  • Para obter os medidores que pertencem a um ativo específico, é necessário enviar o parâmetro "code" (código do ativo).
  • Para obter a informação de um medidor específico, é necessário enviar os parâmetros "code" (código do ativo) e "serial" (serial do medidor).

Parâmetros de entrada

ParâmetroTipoRequeridoDescrição
codeTextoOpcionalCódigo do ativo que tem associado o medidor.
serialTextoOpcionalSerial do medidor que se deseja consultar.
startInteiroOpcionalCampo que serve para fazer a paginação de registros. É o número em que começa a paginação. Por padrão é 0
limitInteiroOpcionalQuantidade de registros (itens) que deseja que a API retorne. Por padrão é 100 (Não pode ser superior a este valor)
location_codeTextoOpcionalCódigo da localização principal (Localização pai) para consultar os medidores vinculados às suas localizações secundárias (filhas).

Parâmetros de saída

Parâmetro

Tipo

Descrição

active

Booleano

Indica o estado do medidor, permitindo identificar se está habilitado ou não.

description

Texto

Descrição do Medidor

serial

Texto

Serial do medidor

is_counter

Texto

Valor que indica se o medidor é do tipo contador

counter_offset_value

Texto

Valor Acumulado

counter_value

Texto

Valor atual do medidor

last_data

Texto

Informação da última leitura adicionada ao medidor:
-"date": data,
-"value": valor,
-"accumulated_value": valor acumulado

monthly_average_data

Texto

Valor médio mensal

units_description

Texto

Descrição da unidade do medidor

units_code

Texto

Código da Unidade do medidor

items_description

Texto

Descrição do ativo ao qual pertence o medidor

parent_description

Texto

Localização à qual pertence o ativo

monthly_average_auto

Booleano

Valor que indica se a média mensal será calculada pelo sistema ou será inserida manualmente pelo usuário

min_value

Número

Valor mínimo do medidor

max_value

Número

Valor máximo do medidor

code

Texto

Código do ativo

Exemplo:

Solicitação: (GET)https://app.fracttal.com/api/meters/?code=12345&serial=4789

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id": 695729,
            "active": true,
            "description": "AMPERIMETRO 3",
            "serial": "",
            "is_counter": false,
            "counter_offset_value": 0,
            "counter_value": 0,
            "last_data": null,
            "monthly_average_data": 0,
            "units_description": "AMPERAJE",
            "units_code": "A",
            "items_description": "BASE INFRAESTRUCTURA",
            "parent_description": "/// ",
            "monthly_average_auto": false,
            "min_value": null,
            "max_value": null,
            "code": "",
            "is_monitored": null,
            "default_min": null,
            "default_max": null,
            "id_company": 1190
        },
        {
            "id": 354,
            "active": true,
            "description": "0173-HORAS",
            "serial": "",
            "is_counter": true,
            "counter_offset_value": 0,
            "counter_value": 1,
            "last_data": {
                "date": "2014-04-27T03:00:00+00:00",
                "value": 1,
                "accumulated_value": 1
            },
            "monthly_average_data": 0,
            "units_description": "HORAS",
            "units_code": "HS",
            "items_description": "0173 AUTOMOVIL CITROEN C3",
            "parent_description": "/// ",
            "monthly_average_auto": true,
            "min_value": null,
            "max_value": null,
            "code": "77222",
            "is_monitored": false,
            "default_min": 0,
            "default_max": 0,
            "id_company": 1
        }
    ],
    "total": 26855
}

TESTAR CONEXÃO

Language