Insight API

APIs für Gebäudeenergie, Nachhaltigkeit und Whole-Life Carbon

Binden Sie die Analyse-, Simulations- und Optimierungsengine von CAALA in Ihre Werkzeuge ein. Programmatischer Zugriff auf Energieeffizienz, Nachhaltigkeit und detaillierte Whole-Life-Carbon-Bilanzierung (WLCA) für Gebäudeentwürfe.

Zur Dokumentation Zugang anfragen

Gebäudefassade aus schräg gestellten weißen Paneelen, in jedem Feld wächst eine kleine Pflanze

Was Sie bauen können

Eine API für die Gebäudeperformance

Die CAALA Insight API stellt die Analyse-, Simulations- und Optimierungswerkzeuge der CAALA Software bereit, damit Sie diese in Ihre eigenen Workflows einbauen können.

CO₂- und Energieanalyse integrieren

Führen Sie die Energieeffizienz- und Nachhaltigkeitsanalyse von CAALA für Gebäudeentwürfe direkt in Ihrem eigenen Produkt oder Ihrer Pipeline aus.

WLCA automatisieren

Erstellen Sie detaillierte Whole-Life-Carbon-Bilanzen programmatisch, ohne manuelle Neueingabe und mit durchgängig einheitlicher Methodik.

Entwürfe im großen Maßstab optimieren

Simulieren und optimieren Sie Varianten, um Optionen hinsichtlich Energie- und Nachhaltigkeitsperformance über viele Projekte hinweg zu vergleichen.

Produktionsreife API

Versionierte Routen, Bearer-Authentifizierung, planbare Rate Limits und ein klares Fehlermodell. Alles in der API-Referenz dokumentiert.

Anwendungsfälle

Gebaut für die Entscheidungen, die Projekte und Portfolios voranbringen

Die Analysen von CAALA unterstützen bereits Projektentwickler:innen, Bestandshalter:innen, Architekt:innen und Berater:innen, vom frühen Entwurf über die QNG-Förderung bis zum Sanierungsfahrplan. Mit der API bringen Sie diese Analysen in Ihr eigenes Produkt oder Ihren Workflow.

Projektentwickler:innen · Architekt:innen

Optimierungspotentialanalyse

Für die klimaneutrale Projektentwicklung.

Vergleichen Sie früh einen Worst Case, den aktuellen Entwurf und einen Best Case hinsichtlich operativem und grauem CO₂, gemessen an den QNG-Grenzwerten, solange Änderungen noch günstig sind.

Was Sie bauen können
Binden Sie den Variantenvergleich in Ihr Machbarkeits-, Entwurfs- oder Konfigurator-Tool ein.

Anwendungsfall besprechen
Projektentwickler:innen · Architekt:innen · Energieberater:innen

QNG-Konformitätsprüfung

Um früh zu wissen, ob ein Entwurf qualifiziert ist.

Prüfen Sie einen Entwurf gegen die Grenzwerte von QNG-Plus und QNG-Premium für Treibhausgasemissionen und Primärenergiebedarf, mit getrennt ausgewiesenen Betriebsemissionen und grauen Emissionen und einem klaren Ergebnis je Grenzwert.

Was Sie bauen können
Zeigen Sie die QNG-Konformität live in Ihrem Entwurfs- oder Machbarkeits-Tool, damit Teams nachsteuern können, bevor der Entwurf feststeht.

Anwendungsfall besprechen
Projektentwickler:innen · Energieberater:innen

QNG-Nachweis für die KfW-Förderung

Um die Förderung für klimafreundlichen Neubau zu sichern.

Erbringen Sie den QNG-Nachweis für Treibhausgase und Primärenergie im Lebenszyklus. Grundlage sind Ihre Planunterlagen (IFC-Datei, falls vorhanden), der Wärmeschutznachweis und ein Bauteilkatalog. Das Ergebnis ist die fertige Nachweis-Dokumentation für das QNG-Siegel.

Was Sie bauen können
Machen Sie den QNG-Nachweis zu einem wiederholbaren Schritt in Ihrem Förder- oder Zertifizierungsprozess: Projektdaten übergeben, Dokumentation erhalten.

Anwendungsfall besprechen
Berater:innen · Architekt:innen · Ingenieur:innen

Ökobilanzierung für Reporting und Zertifizierungen

Für ein fundiertes Reporting und Zertifizierungen.

Erstellen Sie belastbare Whole-Life-Carbon-Ergebnisse und exportieren Sie diese in die Berichte und Zertifizierungsprozesse, die Sie bereits nutzen.

Was Sie bauen können
Automatisieren Sie die WLCA in Ihrer Reporting-Pipeline, statt Daten manuell neu zu erfassen.

Anwendungsfall besprechen
Bestandshalter:innen · Asset Manager

CO₂-Risikoanalyse

Für die Wertsicherung Ihrer Portfolios.

Machen Sie CO₂-Risiken über Ihren Gebäudebestand sichtbar, bevor sie zu einer Frage des Objektwerts werden.

Was Sie bauen können
Speisen Sie CO₂-Ergebnisse in Ihr Portfolio-Reporting, Ihr Benchmarking und Ihre Investment-Tools ein.

Anwendungsfall besprechen
Bestandshalter:innen · Berater:innen

Sanierungspotentialanalyse

Für eine fundierte Dekarbonisierungsstrategie.

Prüfen Sie bis zu drei Sanierungsvarianten je Gebäude technisch und wirtschaftlich. Sehen Sie die Wirkung auf Verbrauch, Emissionen und Stranding-Zeitpunkt, mit Kosten, BEG-Förderung und CO₂-Vermeidungskosten je Maßnahmenpaket sowie einem Klimaschutzfahrplan nach CRREM.

Was Sie bauen können
Versorgen Sie Sanierungsplanung und Roadmap-Tools mit dem Verbrauch der letzten drei Jahre, Bestandsunterlagen und grundlegenden Gebäudedaten.

Anwendungsfall besprechen

Bewährt in den Referenzprojekten von CAALA

Veröffentlichte Referenzprojekte zeigen, wie Teams CAALA in der Praxis einsetzen.

Haben Sie einen Anwendungsfall im Blick?

Erzählen Sie uns, was Sie bauen, und wir zeigen Ihnen, wie die API passt.

Technisches Gespräch buchen CAALA Software ansehen

Für Unternehmen

Gebaut für anspruchsvolle Integrationen

Eine überzeugend dokumentierte Produktions-API für Teams, die Gebäudeperformance und CO₂-Analysen in ihre eigenen Plattformen einbetten.

Technisches Gespräch buchen

Zuverlässigkeit

Eine produktive API mit versionierten Routen, einem Health-Endpunkt und planbarer Rate-Limitierung.

Sicherheit und Datenschutz

Bearer-Token-Authentifizierung mit kurzlebigen Session-Tokens. Informationen zu DSGVO und Datenresidenz auf Anfrage.

Details auf Anfrage

Versionierungsdisziplin

Versionierte Routen (/v1), damit Integrationen nicht unerwartet brechen.

Support

Direkter Zugang zum CAALA-Team für die technische Evaluierung und die Unterstützung bei der Integration.

Details auf Anfrage

Demnächst verfügbar Nur für Enterprise

Datenbereitstellung

Die vollständigen Daten Ihres Mandanten als Service

Ein vollständig verwaltetes Daten-Backend für Enterprise-Kunden. Die Managed Services von CAALA und Ihre eigenen CAALA-Nutzer:innen speisen die Daten Ihres Mandanten im Data Lake von CAALA. Über verwaltete APIs fragen Sie alles ab und versorgen Ihre eigenen Dashboards, SAP und weitere ERP-Systeme.

Managed Services von CAALA Von CAALA erstellte Analysen und Ergebnisse
Ihre CAALA-Nutzer:innen Die Arbeit Ihres Teams in CAALA

Ihre Mandantendaten Zusammengeführt im Data Lake von CAALA

Verwaltete Daten-API Betrieben von CAALA

Interne Dashboards
SAP
Weitere ERP-Systeme

Illustration eines Dashboards auf Basis von Mandantendaten.

Vollständige Mandantenabfrage

Fragen Sie den kompletten Datenbestand Ihres Mandanten ab, nicht nur einzelne Projekte oder Berichte.

Für Ihre Systeme gebaut

Binden Sie interne Dashboards, SAP und weitere ERP-Software an, ohne eine eigene Datenpipeline aufzubauen.

Vollständig verwaltet

CAALA betreibt das Daten-Backend, damit Ihre Teams ihre Zeit in Dashboards und Entscheidungen stecken statt in Infrastruktur.

Sie planen damit? Sprechen Sie mit uns über Ihren Datenbedarf.

Interesse anmelden

API-Überblick

Alles für Ihre Integration

Zwei Einstiegspunkte: die v1-Referenz und die maschinenlesbare Spezifikation.

Aktuell

v1-Referenz

Alle Endpunkte der CAALA Insight API v1 mit ihren Request- und Response-Modellen. Der richtige Einstieg für neue Integrationen.

v1-Referenz öffnen

Spezifikation

OpenAPI-JSON

Die maschinenlesbare Spezifikation für v1. Nutzen Sie sie, um Client-Code zu generieren oder die API in Werkzeuge wie Postman zu importieren.

OpenAPI-JSON öffnen

Schnellstart

Ihre erste Anfrage in zwei Schritten

Die Authentifizierung läuft in zwei Schritten: Tauschen Sie einen von CAALA ausgestellten Access-Key gegen ein Session-Token und rufen Sie die API anschließend mit einem Bearer-Token auf.

1

Access-Key anfragen

Access-Keys werden von CAALA ausgestellt, und eine öffentliche Selbstregistrierung gibt es noch nicht.
2

Gegen ein Session-Token tauschen

Senden Sie den Key per POST an /v1/auth/access-keys/exchange-key und erhalten Sie ein kurzlebiges Session-JWT.
3

Mit Bearer-Token aufrufen

Senden Sie bei jeder authentifizierten Anfrage Authorization: Bearer <sessionJwt> mit.

Vollständige API-Referenz

# Schritt 1: Access-Key (10–124 Zeichen) gegen ein Session-Token tauschen
curl -X POST https://api.caala.de/v1/auth/access-keys/exchange-key \
  -H "Content-Type: application/json" \
  -d '{ "accessKey": "<your-access-key>" }'
# → { "keyId": "...", "sessionJwt": "..." }

# Schritt 2: authentifizierten Endpunkt aufrufen
curl https://api.caala.de/v1/... \
  -H "Authorization: Bearer <sessionJwt>"

import requests

BASE = "https://api.caala.de"

# Schritt 1: Access-Key gegen ein Session-Token tauschen
auth = requests.post(
    f"{BASE}/v1/auth/access-keys/exchange-key",
    json={"accessKey": "<your-access-key>"},
    timeout=30,
)
auth.raise_for_status()

# HINWEIS: JSON-Schreibweise (sessionJwt) vor dem Einsatz mit der Live-Spezifikation abgleichen.
token = auth.json()["sessionJwt"]

# Schritt 2: API mit dem Bearer-Token aufrufen
response = requests.get(
    f"{BASE}/v1/...",
    headers={"Authorization": f"Bearer {token}"},
    timeout=30,
)

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://api.caala.de/") };

// Schritt 1: Access-Key gegen ein Session-Token tauschen
var auth = await http.PostAsJsonAsync(
    "v1/auth/access-keys/exchange-key",
    new { accessKey = "<your-access-key>" });
auth.EnsureSuccessStatusCode();

// HINWEIS: JSON-Schreibweise (sessionJwt) vor dem Einsatz mit der Live-Spezifikation abgleichen.
var token = await auth.Content.ReadFromJsonAsync<ExchangeResponse>();

// Schritt 2: API mit dem Bearer-Token aufrufen
http.DefaultRequestHeaders.Authorization =
    new("Bearer", token!.SessionJwt);

var response = await http.GetAsync("v1/...");

record ExchangeResponse(string KeyId, string SessionJwt);

FAQ

Häufige Fragen

Keine Antwort gefunden? Schreiben Sie an info@caala.de oder erreichen Sie das Team über die Support-Seite.

Wie erhalte ich einen Access-Key?

Access-Keys werden von CAALA ausgestellt, und eine öffentliche Selbstregistrierung gibt es derzeit nicht. Fordern Sie einen Key über die Kontaktseite an, das Team richtet Sie dann ein.

Wie funktioniert die Authentifizierung?

In zwei Schritten: Senden Sie Ihren Access-Key per POST an /v1/auth/access-keys/exchange-key, um ein kurzlebiges Session-Token zu erhalten, und senden Sie dann bei authentifizierten Anfragen Authorization: Bearer <sessionJwt> mit.

Welche Rate Limits gelten?

Feste Ein-Minuten-Fenster: 100 Anfragen pro Minute für öffentliche Endpunkte und 50 Anfragen pro Minute für strikte Endpunkte. Bei Überschreitung folgt sofort die Antwort 429, und Anfragen werden nicht in eine Warteschlange gestellt.

Gibt es eine Sandbox oder Testumgebung?

Das ist noch offen. Fragen Sie das CAALA-Team nach Test-Access-Keys und einer Sandbox-Umgebung für die Evaluierung.

Wie werden meine Daten verarbeitet (DSGVO)?

Die CAALA GmbH ist ein deutsches Unternehmen und unterliegt der DSGVO. Datenresidenz, Unterauftragsverarbeiter und ein AVV sind auf Anfrage verfügbar. Lesen Sie die Datenschutzerklärung und wenden Sie sich für Details an das Team.

Was kostet es?

Die kommerziellen Konditionen klären Sie direkt mit CAALA. Nehmen Sie über die Kontaktseite Kontakt auf, um Zugang und Preise zu besprechen.

Starten Sie mit CAALA

Fordern Sie einen Access-Key an, um loszulegen, oder sprechen Sie mit unserem Team über eine Enterprise-Integration.

Zugang anfragen Mit dem Vertrieb sprechen