feat: rename remaining German API fields and deprecate legacy endpoints (#1164)
Some checks failed
Bump Version / Bump Version Workflow (push) Has been cancelled
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
docker-build / platform-excludes (push) Has been cancelled
pre-commit / pre-commit (push) Has been cancelled
Run Pytest on Pull Request / test (push) Has been cancelled
docker-build / build (push) Has been cancelled
docker-build / merge (push) Has been cancelled
Close stale pull requests/issues / Find Stale issues and PRs (push) Has been cancelled

Complete the English API translation started in #675:

- rename input fields pv_akku to pv_battery and eauto to ev, and the
  solution fields eautocharge_hours_float to ev_charge_hours_float and
  eauto_obj to ev_obj; the German names are still accepted on input
  via validation aliases and re-emitted in responses as deprecated
  computed fields, same pattern as #675
- mark the legacy endpoints /strompreis, /gesamtlast and
  /gesamtlast_simple as deprecated in the OpenAPI schema
- use amount instead of a euro reference in the battery LCOS log
  message

Co-authored-by: Tobias Welz <tobias.wizneteu@gmail.com>
This commit is contained in:
7tobias
2026-07-21 04:22:50 -04:00
committed by GitHub
parent 641873d867
commit 8d72177671
10 changed files with 215 additions and 101 deletions

View File

@@ -8,7 +8,7 @@
"name": "Apache 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0.html"
},
"version": "v0.3.0.dev2607201457168588"
"version": "v0.3.0.dev2607210205856856"
},
"paths": {
"/v1/admin/cache/clear": {
@@ -1958,7 +1958,8 @@
}
}
}
}
},
"deprecated": true
}
},
"/gesamtlast": {
@@ -2004,7 +2005,8 @@
}
}
}
}
},
"deprecated": true
}
},
"/gesamtlast_simple": {
@@ -2015,6 +2017,7 @@
"summary": "Fastapi Gesamtlast Simple",
"description": "Deprecated: Total Load Prediction.\n\nEndpoint to handle total load prediction.\n\nTotal load prediction starts at 00.00.00 today and is provided for 48 hours.\nIf no prediction values are available the missing ones at the start of the series are\nfilled with the first available prediction value.\n\nArgs:\n year_energy (float): Yearly energy consumption in Wh.\n\nNote:\n Set LoadAkkudoktor as provider, then update data with\n '/v1/prediction/update'\n and then request data with\n '/v1/prediction/list?key=loadforecast_power_w' instead.",
"operationId": "fastapi_gesamtlast_simple_gesamtlast_simple_get",
"deprecated": true,
"parameters": [
{
"name": "year_energy",
@@ -4934,7 +4937,7 @@
"ems": {
"$ref": "#/components/schemas/GeneticEnergyManagementParameters"
},
"pv_akku": {
"pv_battery": {
"anyOf": [
{
"$ref": "#/components/schemas/SolarPanelBatteryParameters"
@@ -4942,7 +4945,8 @@
{
"type": "null"
}
]
],
"description": "PV battery parameters."
},
"inverter": {
"anyOf": [
@@ -4954,7 +4958,7 @@
}
]
},
"eauto": {
"ev": {
"anyOf": [
{
"$ref": "#/components/schemas/ElectricVehicleParameters"
@@ -4962,7 +4966,8 @@
{
"type": "null"
}
]
],
"description": "Electric vehicle parameters."
},
"dishwasher": {
"anyOf": [
@@ -5012,13 +5017,12 @@
"description": "Can be `null` or contain a previous solution (if available)."
}
},
"additionalProperties": false,
"type": "object",
"required": [
"ems",
"pv_akku",
"pv_battery",
"inverter",
"eauto"
"ev"
],
"title": "GeneticOptimizationParameters",
"description": "Main parameter class for running the genetic energy optimization.\n\nCollects all model and configuration parameters necessary to run the\noptimization process, such as forecasts, pricing, battery and appliance models."
@@ -5328,7 +5332,7 @@
"title": "Discharge Allowed",
"description": "Array with discharge values (1 for discharge, 0 otherwise)."
},
"eautocharge_hours_float": {
"ev_charge_hours_float": {
"anyOf": [
{
"items": {
@@ -5340,13 +5344,13 @@
"type": "null"
}
],
"title": "Eautocharge Hours Float",
"description": "TBD"
"title": "Ev Charge Hours Float",
"description": "Array with EV charging values as relative power (0.0-1.0), or `null` if no EV is optimized."
},
"result": {
"$ref": "#/components/schemas/GeneticSimulationResult"
},
"eauto_obj": {
"ev_obj": {
"anyOf": [
{
"$ref": "#/components/schemas/ElectricVehicleResult"
@@ -5354,7 +5358,8 @@
{
"type": "null"
}
]
],
"description": "Electric vehicle state after optimization."
},
"start_solution": {
"anyOf": [
@@ -5382,16 +5387,47 @@
],
"title": "Washingstart",
"description": "Can be `null` or contain an object representing the start of washing (if applicable)."
},
"eautocharge_hours_float": {
"anyOf": [
{
"items": {
"type": "number"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Eautocharge Hours Float",
"description": "Deprecated: Use ev_charge_hours_float instead.",
"deprecated": true,
"readOnly": true
},
"eauto_obj": {
"anyOf": [
{
"$ref": "#/components/schemas/ElectricVehicleResult"
},
{
"type": "null"
}
],
"description": "Deprecated: Use ev_obj instead.",
"deprecated": true,
"readOnly": true
}
},
"additionalProperties": false,
"type": "object",
"required": [
"ac_charge",
"dc_charge",
"discharge_allowed",
"eautocharge_hours_float",
"ev_charge_hours_float",
"result",
"ev_obj",
"eautocharge_hours_float",
"eauto_obj"
],
"title": "GeneticSolution",