get
https://app.fracttal.com/api/meters/
Mediante esta API se consulta el listado de los medidores creados en Fracttal. Permite filtrar para obtener solo los medidores que necesitas: por el código del activo, por el serial del medidor o por una ubicación.
- Para obtener los medidores que pertenecen a un activo específico, envía el parámetro
code(código del activo). - Para obtener la información de un medidor en específico, envía los parámetros
code(código del activo) yserial(serial del medidor). - Para obtener los medidores de los activos vinculados a una ubicación y a sus ubicaciones secundarias (hijas), envía el parámetro
location_code.
GET https://app.fracttal.com/api/metersPará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 se desea que el API devuelva. Por defecto es 100 (no puede ser superior a este 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 |
|---|---|---|
id | entero | Identificador del medidor. |
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 | booleano | Indica si el medidor es de tipo contador (acumulador). |
counter_offset_value | número | Valor base del contador. Es el valor sobre el cual se suman las lecturas para obtener el acumulado; por ejemplo, se actualiza cuando el contador se reinicia. No es el valor acumulado. |
counter_value | número | Valor acumulado actual del contador (valor base más las lecturas registradas). |
last_data | objeto | Información de la última lectura agregada al medidor. Ver estructura en la tabla siguiente. |
monthly_average_data | número | 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 cual pertenece el medidor. |
parent_description | texto | Localización a la cual pertenece el activo. |
monthly_average_auto | booleano | 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. |
is_monitored | booleano | Indica si el medidor está siendo monitoreado. |
default_min | número | Valor mínimo por defecto del medidor. |
default_max | número | Valor máximo por defecto del medidor. |
alert_high_preventive_value | número | Umbral alto preventivo del estado del medidor. No aplica a contadores (is_counter = true). |
alert_high_preventive_enabled | booleano | Indica si el umbral alto preventivo está habilitado. |
alert_high_critical_value | número | Umbral alto crítico del estado del medidor. No aplica a contadores (is_counter = true). |
alert_high_critical_enabled | booleano | Indica si el umbral alto crítico está habilitado. |
alert_low_preventive_value | número | Umbral bajo preventivo del estado del medidor. No aplica a contadores (is_counter = true). |
alert_low_preventive_enabled | booleano | Indica si el umbral bajo preventivo está habilitado. |
alert_low_critical_value | número | Umbral bajo crítico del estado del medidor. No aplica a contadores (is_counter = true). |
alert_low_critical_enabled | booleano | Indica si el umbral bajo crítico está habilitado. |
alert_current_state | texto | Estado actual de alerta del medidor. Si no se ha registrado ningún cambio de estado, el valor es NORMAL. |
Estructura de last_data:
| Parámetro | Tipo | Descripción |
|---|---|---|
date | texto | Fecha de la última lectura (formato ISO 8601). |
value | número | Valor de la última lectura. |
accumulated_value | número | Valor acumulado del contador al momento de la última lectura. |
Cómo obtener el valor acumulado de un contadorPara conocer el valor acumulado de un medidor de tipo contador, utiliza
counter_value(valor acumulado actual) olast_data.accumulated_value(valor acumulado a la fecha de la última lectura).El campo
counter_offset_valuecorresponde al valor base del contador y no debe interpretarse como el acumulado.
Errores
| Código | Causa |
|---|---|
404 | El código enviado en location_code no existe en la compañía. |
500 | Error interno al procesar la consulta. |
Ejemplo
Request
GET https://app.fracttal.com/api/meters/?code=12345&serial=4789Response 200
200{
"success": true,
"message": "200",
"data": [
{
"id": 1001,
"active": true,
"description": "Horómetro generador",
"serial": "4789",
"is_counter": true,
"counter_offset_value": 1500,
"counter_value": 1620,
"last_data": {
"date": "2026-10-20T08:30:00+00:00",
"value": 120,
"accumulated_value": 1620
},
"monthly_average_data": 45,
"units_description": "HORAS",
"units_code": "HS",
"items_description": "Generador eléctrico 01",
"parent_description": "/ Planta principal / ",
"monthly_average_auto": true,
"min_value": null,
"max_value": null,
"code": "12345",
"is_monitored": false,
"default_min": 0,
"default_max": 0,
"alert_high_preventive_value": null,
"alert_high_preventive_enabled": false,
"alert_high_critical_value": null,
"alert_high_critical_enabled": false,
"alert_low_preventive_value": null,
"alert_low_preventive_enabled": false,
"alert_low_critical_value": null,
"alert_low_critical_enabled": false,
"alert_current_state": "NORMAL"
}
],
"total": 1
}Response — ubicación no encontrada (404)
404){
"success": false,
"message": "404",
"data": [
{
"ERROR": "Location code LOC-999 was not found in your company"
}
],
"total": 0
}