REST API (1.0.0)

Download OpenAPI specification:

Wattos Support: support@wattos.link URL: https://wattos.link/support

REST API Specification for Wattos Energy Management System. This API provides endpoints for managing sites, resources, and retrieving data from various energy systems including meters, BESS, and PV systems.

Get a list of sites belonging to the specified Group ID

Authorizations:

BearerAuth

query Parameters

group_id

required

string^[A-Z0-9]{8}$

8-digit alphanumeric group ID to filter sites

Responses

Response samples

Content type

application/json

{"sites": [{"site_id": "SITE0001",
"group_id": "GROUP0001",
"site_name": "LA Business Center",
"site_latitude": 34.0522,
"site_longitude": -118.2437
}
]
}

Get a list of resources installed at the specified Site ID

Authorizations:

BearerAuth

path Parameters

site_id

required

string^[A-Z0-9]{8}$

8-digit alphanumeric site ID to filter resources

Responses

Response samples

Content type

application/json

{"resources": [{"resource_id": "PV000001",
"resource_type": "PV",
"unit_controller_id": "UC000001",
"resource_name": "Rooftop Solar Array A1",
"resource_latitude": 34.0195,
"resource_longitude": -118.4912
}
]
}

Get meter measurement data for the specified resource

Authorizations:

BearerAuth

query Parameters

resource_id	string^[A-Z0-9]{8}$ 8-digit alphanumeric resource ID (optional)
start required	string <date-time> Data aggregation start time (ISO 8601, UTC, seconds fixed to 00). Must be longer than the interval specified in agg_interval.
end required	string <date-time> Data aggregation end time (ISO 8601, UTC, seconds fixed to 00). Must be longer than the interval specified in agg_interval.
agg_interval required	integer Enum: 1 5 15 30 Aggregation interval (1: 1 minute, 5: 5 minutes, 15: 15 minutes, 30: 30 minutes)

Responses

Response samples

Content type

application/json

{"datas": [{"resource_id": "ME000001",
"timestamp": "2024-03-20T00:00:00Z",
"agg_interval": 15,
"unit_controller_id": "UC000001",
"power_active_avg": 45.7,
"power_active_max": 50,
"power_apparent_avg": 48.2,
"power_reactive_avg": 15.3,
"energy_active_cum": 22.3
}
]
}

Get BESS system performance metrics for the specified resource

Authorizations:

BearerAuth

query Parameters

resource_id	string^[A-Z0-9]{8}$ 8-digit alphanumeric resource ID (optional)
start required	string <date-time> Data aggregation start time (ISO 8601, UTC, seconds fixed to 00). Must be longer than the interval specified in agg_interval.
end required	string <date-time> Data aggregation end time (ISO 8601, UTC, seconds fixed to 00). Must be longer than the interval specified in agg_interval.
agg_interval required	integer Enum: 1 5 15 30 Aggregation interval (1: 1 minute, 5: 5 minutes, 15: 15 minutes, 30: 30 minutes)

Responses

Response samples

Content type

application/json

{"datas": [{"resource_id": "BE000001",
"timestamp": "2024-03-20T00:00:00Z",
"agg_interval": 15,
"unit_controller_id": "UC000001",
"power_charge_active_avg": 45,
"power_charge_active_max": 60,
"power_discharge_active_avg": 45,
"power_discharge_active_max": 55,
"energy_charge_active_cum": 500,
"energy_discharge_active_cum": 450,
"soc_end": 80,
"temp_cell_max": 35,
"temp_ambient_max": 25,
"status": "CH"
}
]
}

Get PV system operation and performance metrics for the specified resource

Authorizations:

BearerAuth

query Parameters

resource_id	string^[A-Z0-9]{8}$ 8-digit alphanumeric resource ID (optional)
start required	string <date-time> Data aggregation start time (ISO 8601, UTC, seconds fixed to 00). Must be longer than the interval specified in agg_interval.
end required	string <date-time> Data aggregation end time (ISO 8601, UTC, seconds fixed to 00). Must be longer than the interval specified in agg_interval.
agg_interval required	integer Enum: 1 5 15 30 Aggregation interval (1: 1 minute, 5: 5 minutes, 15: 15 minutes, 30: 30 minutes)

Responses

Response samples

Content type

application/json

{"datas": [{"resource_id": "PV000001",
"timestamp": "2024-03-20T00:00:00Z",
"agg_interval": 15,
"unit_controller_id": "UC000001",
"power_active_avg": 35,
"power_active_max": 40,
"energy_active_cum": 300,
"temp_cell_max": 45,
"temp_ambient_max": 25,
"status": "ON"
}
]
}