Versionsarchiv via REST API
Das Versionsarchiv dokumentiert Änderungen an den baubook-Produktdaten und Kennwerten. Die Versionierung ist ab Version 3 auch via REST API Schnittstelle verfügbar.
Wissen, was sich geändert hat — feldgenau, tagesgenau, reproduzierbar
Die baubook REST-API bietet ab Version 3 eine inhaltsbasierte Änderungshistorie (Versionsarchiv) zu den enthaltenen Richtwerten und Produktdaten. Datenbezieher:innen erfahren tagesgenau, welche Felder sich geändert haben. Für Programmhersteller bzw. deren Software bedeutet das, dass zur Datenaktualisierung nur noch das echte Änderungsdelta geladen und synchronisiert werden muss statt wie bisher der komplette Datenbestand („Delta Sync“).
Programmhersteller profitieren vom Delta-Sync
Programmhersteller erhalten dank Delta-Sync eine komfortable Lösung. Ein einziger Parameter genügt: „modified since“ liefert ausschließlich Produkte mit inhaltlichen Änderungen ab dem letzten Abgleich. Das spart Bandbreite, Rechenzeit und Wartezeit. Jedes Produkt trägt dazu Metadaten (modified, last_change), die auf einen Blick zeigen, was zuletzt passiert ist.
Dokumentierte Datenverknüpfung zu Richtwerten
Die mit den Produkten verknüpften Richtwerte fließen in die Produktdarstellung ein. Ändert sich ein Richtwert, der ein Produkt betrifft, erscheint das in der Änderungshistorie — als eigener, klar gekennzeichneter Eintrag. Alle Änderung sind einfach ersichtlich und dokumentiert. Reproduzierbare Stichtage Mit der Versionierung können auch frühere Datenstände per Stichtag (rückwirkend bis Mai 2025) abgerufen werden. Ob Energieausweis oder Ökobilanz — mit dem Stichtagsabruf liefert die API den exakten Produktdatenstand zu jedem Datum („as-of"). Eine Berechnung vom März lässt sich im Dezember mit den Märzdaten belegen. Der Diff-Endpoint zeigt zusätzlich Feld für Feld, was sich zwischen zwei Stichtagen geändert hat — inklusive alter und neuer Werte.
Simple Integration
Die REST, JSON-Schnittstelle bietet ein vollständiges OpenAPI-Schema — generierte Clients (NSwag, Kiota & Co.) funktionieren out of the box. Die interaktive Doku, das Swagger-UI und ein maschinenlesbarer Einstieg für KI-Assistenten (llms.txt) vereinfachen die Integration.
Sie sind Programmhersteller und haben Interesse? Wir freuen uns!
Nützen Sie bitte unser Antragsformular.