Limits & errors
Request limits
| Item | Limit |
|---|---|
| Daily performance window | 366 days |
| Returned rows | 1,000 |
| Serialized response | 1 MB |
get_plant_daily_performance reads daily values only. It has no interval
input. Use get_plant_chart for a one-day chart or query_plant_5min for
stored five-minute Plant values.
If a result is truncated, the response says so. Ask for a smaller date range.
Common errors
| Error | Meaning | What to do |
|---|---|---|
| Authentication required | The Public API rejected the signed-in identity. | Reconnect the assistant and sign in again. |
| Authentication not configured | The connector's backend identity link is not set up, or your account has no recorded Plant scope. | Contact AVA Asia. Retrying will not fix this. |
| Forbidden | The Plant ID is outside the connected account's access, or it does not exist. | Confirm the Plant ID from a discovery call, or ask AVA Asia to review access. |
| Invalid query | A date, interval, ID, or search text is not valid. | Give a complete daily date range, a valid Plant ID, and a non-empty search query. |
| Query limit exceeded | The result would exceed 1,000 rows or 1 MB of serialized data. | Ask for a smaller date range. |
| Unavailable | The SolarSENS Public API could not be reached or rejected the request. | Retry later or narrow the request. |
| Upstream invalid response | The Public API returned data the connector could not parse. | Retry later. Contact AVA Asia if it persists. |
Coverage and warnings
Every successful response sets metadata.coverage and metadata.warnings.
The server sets them from the returned values only:
| Result | Coverage | Warning |
|---|---|---|
| Daily performance, with no rows for the window | unavailable | NO_DATA_FOR_WINDOW |
Daily performance, where a measured value is null in any row | partial | MISSING_VALUES |
| Daily performance, with every measured value present | complete | none |
| Daily performance or Plant values, where a value exceeds its unit's limit (a percent above 100, daily irradiation above 12 kWh/m² or 12,000 Wh/m²) | unchanged | IMPLAUSIBLE_VALUES |
| Monitoring screen data (dashboard, chart, device, and string views) | complete | COVERAGE_NOT_ASSESSED |
A null value is missing, not zero. unavailable means no data for the
window, not zero production. Monitoring screen data is passed through as
SolarSENS returned it, and the server does not check it. The complete
value on those responses is not a claim that the data is complete. Read
COVERAGE_NOT_ASSESSED as "not checked". Each warning code is a stable
string; a new code is a contract change. IMPLAUSIBLE_VALUES marks a value
that is mislabelled or wrong upstream; the server does not correct it.