baubook Versionsarchiv via REST API
Das Versionsarchiv basiert auf den deklarierten Kerndaten, die auch in der baubook-Export-Schnittstelle V3 enthalten sind. Die Versionierung ist ab Version 3 via REST API Schnittstelle verfügbar.
Wissen, was sich geändert hat — feldgenau, tagesgenau, nachweisbar
Die baubook REST-API bietet ab Version 3 eine inhaltsbasierte Änderungshistorie (Versionsarchiv) zu den Produktdaten. Datenbezieher:innen erfahren tagesgenau welche Felder sich geändert haben. Für Programmhersteller bzw. deren Software bedeutet das, dass zur Datenaktualisierung nur das echte Änderungsdelta, anstelle bisheriger Volldownloads geladen und synchronisiert werden muss. Mit der Versionierung können auch frühere Datenstände per Stichtag (rückwirkend bis Mai 2025) abgerufen werden. Damit werden Berechnungen auch mit veränderten Daten belegbar.
Programmhersteller profitieren vom Delta-Sync
Ein einziger Parameter genügt: modified since liefert ausschließlich Produkte mit inhaltlichen Änderungen ab dem letzten Abgleich. Das spart Bandbreite, Rechenzeit und Wartezeit. Die Produktdatenbank ist in Sekunden statt Minuten aktuell. Jedes Produkt trägt dazu Metadaten (modified, last_change), die auf einen Blick zeigen, was zuletzt passiert ist. Softwareentwicklern bieten wir mit dem Delta-Sync eine komfortable Lösung an.
Dokumentierte Datenverknüpfung
baubook-Produkte leben nicht isoliert: Die mit Richtwerten verknüpften Produkte 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
Ob Energieausweis, Förderabwicklung oder Ökobilanz — mit dem Stichtags-Abruf 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. Die Nachweisbarkeit der Daten steht im Mittelpunkt.
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.