GET /catalog listet sie live auf). Jede Domäne
enthält normalisierte Category-Endpunkte unter /{category}/{table}, sowie entsprechende
Raw-Tabellen unter /raw/{table_name} für den Bulk-Export.
Property
Objekte, Objekt-Kreditor-Dienstleistungen, der Objektstrukturbaum und technische Objekte.
Contracts
Mietsollstellungen, Sollstellungsabweichungen, Dienstleistungsverträge und Vertragsenden.
Accounting
Kontenplan, Buchungsköpfe und -positionen, Budgets und Kontenmapping-Bereiche.
Depreciation
Anlagegüter und ihre Abschreibungsbuchungen.
Operations
Meldungen, Angebote, Aufträge und Projekte.
Stakeholder
Kreditoren, Mitarbeiter, Eigentümer und Mieter.
Zwei Domänen, auf die in früheren Entwürfen dieser Dokumentation verwiesen wurde — Meters
und Market Data — existieren nicht als Live-API-Kategorien. Es gibt keinen Endpunkt für
Zählerstände oder Verbrauchsdaten und keinen Endpunkt für Marktvergleichswerte. Die einzige
Spur von Metering im aktuellen Datenmodell ist ein
is_meter-Flag auf einzelnen
technical_objects-Zeilen; der Verlauf des Energieverbrauchs wird in einer separaten,
internen Pipeline verarbeitet, die nicht über diese API bereitgestellt wird. Baue keine
Integrationen gegen einen Meters- oder Market-Data-Endpunkt — sie liefern einen 404-Fehler.Wie die Domänen zusammenhängen
property_id ist der primäre Verknüpfungsschlüssel. Jede Domäne außer Stakeholder.creditor
führt property_id, sodass sich jeder Datensatz auf ein Objekt in Property.properties
zurückführen lässt.
Verknüpfungsschlüssel im Detail
Die oben genannten Kardinalitäten beschreiben das beabsichtigte Datenmodell (1:N über
Fremdschlüsselspalten). Sie sind nicht unabhängig gegen Live-Zeilenzahlen verifiziert — wenn
du dich auf strikte Eindeutigkeit eines Schlüssels verlässt, validiere dies zuerst gegen
deinen eigenen Datensatz.