odoo_mqtt/iot_bridge/API.md

IoT Bridge HTTP API

Diese Datei ist eine kurze Orientierung. Die verbindliche API-Dokumentation wird durch FastAPI/OpenAPI bereitgestellt.

Base URL: http://<bridge-host>:8080

Source of Truth

• Swagger UI: http://<bridge-host>:8080/docs
• ReDoc: http://<bridge-host>:8080/redoc
• OpenAPI JSON: http://<bridge-host>:8080/openapi.json

Hinweis: Die OpenAPI-Definition wird direkt aus den aktuellen FastAPI-Routen und Pydantic-Modellen erzeugt.

Authentifizierung

Authentifizierung ist optional. Wenn BRIDGE_API_TOKEN gesetzt ist, benötigen geschützte Endpunkte:

Authorization: Bearer <token>

Bei fehlendem oder ungültigem Token antwortet die API mit 401 bzw. 403.

Wichtigste Endpunkte (Kurzüberblick)

• GET /health – Health-Status der Bridge.
• POST /config – Konfiguration von Odoo übernehmen (inkl. MQTT-Reconnect bei Broker-Änderung).
• GET /config – aktuell aktive Konfiguration zurückgeben.

Für Request-/Response-Schemata und alle Felddetails bitte immer Swagger/ReDoc verwenden.