get https://app.fracttal.com/api/meters/
Mediante esta API se consulta el listado de los medidores creados en Fracttal.
Esta API te permite filtrar para que obtengas sólo los medidores que necesitas: por el código del activo y/o por el serial del medidor.
- Para obtener los medidores que pertenecen a un activo específico, es necesario enviar el parámetro “code” (código del activo).
- Para obtener la información de un medidor en específico, es necesario enviar los parámetros “code” (código del activo) y “serial” (serial del medidor).
Parámetros de entrada
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
code | Texto | Opcional | Código del activo que tiene asociado el medidor. |
serial | Texto | Opcional | Serial del medidor que se desea consultar. |
start | Entero | Opcional | Campo que sirve para hacer la paginación de registros. Es el número en el que comienza la paginación. Por defecto es 0 |
limit | Entero | Opcional | Cantidad de registros (items) que desea que el API devuelva. Por defecto es 100 (No puede ser superior a éste valor) |
location_code | Texto | Opcional | Código de la localización principal (Ubicación padre) para consultar los medidores vinculados a sus ubicaciones secundarias (hijas). |
Parámetros de salida
Parámetro | Tipo | Descripción |
---|---|---|
active | Booleano | Indica el estado del medidor, permitiendo identificar si se encuentra habilitado o no. |
description | Texto | Descripción del Medidor |
serial | Texto | Serial del medidor |
is_counter | Texto | Valor que te indica si el medidor es de tipo contador |
counter_offset_value | Texto | Valor Acumulado |
counter_value | Texto | Valor actual del medidor |
last_data | Texto | Información de la última lectura agregada al medidor: -"date": fecha, -"value": valor, -"accumulated_value": valor acumulado |
monthly_average_data | Texto | Valor promedio mensual |
units_description | Texto | Descripción de la unidad del medidor |
units_code | Texto | Código de la Unidad del medidor |
items_description | Texto | Descripción del activo al cuál pertenece el medidor |
parent_description | Texto | Localización a la cual pertenece el activo |
monthly_average_auto | Booleano | Valor que indica si el promedio mensual será calculado por el sistema o lo ingresará manualmente el usuario |
min_value | Número | Valor mínimo del medidor |
max_value | Número | Valor máximo del medidor |
code | Texto | Código del activo |
Ejemplo:
Petición: (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
}
PROBAR CONEXION