Through this API, you can query advanced information about meters created in Fracttal. It contains information related to the asset it's linked to and information about the last maintenance.
This API allows you to filter to get only the meters you need: by asset code and/or by meter serial.
- To get meters that belong to a specific asset, you need to send the "code" parameter (asset code).
- To get information about a specific meter, you need to send the "code" (asset code) and "serial" (meter serial) parameters.
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
code | Text | Optional | Code of the asset that has the meter associated. |
serial | Text | Optional | Serial of the meter you want to query. |
start | Integer | Optional | Field used for record pagination. It's the number where pagination starts. Default is 0 |
limit | Integer | Optional | Number of records (items) you want the API to return. Default is 100 (Cannot exceed this value) |
Output Parameters
Parameter | Type | Description |
|---|---|---|
description | Text | Meter Description |
serial | Text | Meter serial |
is_counter | Text | Value that indicates if the meter is a counter type |
counter_offset_value | Text | Accumulated Value |
counter_value | Text | Current meter value |
last_data | Text | Information of the last reading added to the meter: -"date": date, -"value": value, -"accumulated_value": accumulated value |
monthly_average_data | Text | Monthly average value |
units_description | Text | Description of the meter unit |
units_code | Text | Code of the meter unit |
items_description | Text | Description of the asset to which the meter belongs |
items_parent_description | Text | Location to which the asset belongs |
id_task | Number | Task ID |
task_description | Text | Task description |
id_task_trigger_type | Number | Trigger type ID. 1: Date, 2: When trigger, 3: Every trigger, 4: Event trigger. |
monthly_average_auto | Boolean | Value indicating if the monthly average will be calculated by the system or manually entered by the user |
last_value_trigger | Number | Reading value at last maintenance |
last_date_maintenance | Date | Date of last maintenance triggered by reading |
id_company | Number | Company ID |
Example:
Request: (GET)https://app.fracttal.com/api/meters_advanced/ACT-001
{
"success": true,
"message": "200",
"data": [
{
"id": 177136,
"is_counter": true,
"active": true,
"description": "Nuevo Medidor Refrigerador",
"serial": "0",
"counter_value": 2405,
"counter_offset_value": 0,
"id_unit": 6,
"units_code": "KM",
"units_description": "KILOMETROS",
"id_parent_meter": null,
"parent_meter_description": " {}",
"monthly_average_data": 1,
"id_item": 20005233,
"items_id_type_item": 2,
"items_code": "SVPRACT13",
"items_description": "SV REFRIGERADOR DE VACUNAS",
"items_id_priority": null,
"items_id_group": null,
"items_id_group_2": null,
"items_field_2": "SV SAMSUNG",
"items_field_3": "SV C13 D",
"items_field_4": "SV 001827",
"items_parent_description": "// ",
"id_task": 2466764,
"tasks_description": "Mantenimiento cada 600km",
"id_task_trigger_type": 3,
"last_value_trigger": "1805",
"last_date_maintenance": "2022-05-27T16:48:28.432111+00:00",
"id_company": 1190
}
],
"total": 1
}