V1-Abschaltung
Die Property-Management-API v1 ist veraltet (deprecated) und wird am 01.01.2027 vollständig abgeschaltet. Die Weiterentwicklung der Plattform findet ausschließlich auf Version 2 statt. Bestehende v1-Schnittstellen laufen bis zum Abschaltdatum stabil weiter, erhalten jedoch keine neuen Funktionen, Performance-Upgrades oder Sicherheitserweiterungen mehr.
Vergleich der API-Versionen
| Eigenschaft | Property-Management-API v1 | Property-Management-API v2 |
|---|---|---|
| Basis-URL | https://api.etg24.de/propertymanagement/v1 | https://api.etg24.de/propertymanagement/v2 |
| Status | Veraltet (Abschaltung am 01.01.2027) | Aktueller Produktionsstandard |
| Architektur | Legacy-RPC-Format | Striktes CQRS (/query/* und /command/*) |
| MCP-Tools | Nicht unterstützt | Vollständige native MCP-Integration |
| Audit-Trail | Basis-Protokollierung | Detailliertes Diff-Logging pro Agent |
Empfohlener Migrationsablauf
Wir empfehlen allen Softwarepartnern und internen Entwicklungsteams von Hausverwaltungen, die Umstellung frühzeitig anzugehen:
- Endpunkte zuordnen: Gleiche deine bisherigen v1-Aufrufe mit den modernen Äquivalenten in der Property-Management-v2-Referenz ab.
- CQRS-Muster übernehmen: Trenne Lese-Workflows (
/query/<domain>) und schreibende Aktionen (/command/<domain>) sauber voneinander. - Authentifizierung aktualisieren: Stelle sicher, dass deine Integration moderne Berechtigungs-Scopes gemäß Identität & Delegation nutzt.
- Parallelbetrieb im Test: Betreibe deine v2-Anbindung in einer Staging-Umgebung parallel zu v1, um Datenparität und Verhalten zu validieren.
Benötigt dein Team Unterstützung oder architektonisches Feedback bei der Umstellung, steht dir unser Entwickler-Support gerne zur Seite.