Die Reonic REST API nutzen

Reonic bietet eine öffentliche REST API, die Haushaltsprojekte, Gewerbliche Projekte, Kontakte, Aufgaben, Teams, Dateien, Termine, Komponenten, Aktivitäten, Status und Pipeline, Tags, Notizen, Planungspakete, Planungsvorlagen, Angebotsvorlagen, Checklistenvorlagen, Leadquellen, Kanban-Boards und -Spalten, Wiki-Inhalte, Photogrammetrie und Zeiterfassung abdeckt.

Wenn es für ein System, das du anbinden willst, bereits eine benannte Integration gibt (HubSpot, Pipedrive, Lexoffice, Bexio, Hero, K2, Microsoft, Google, AroundHome, DAA, Wattfox, Bees & Bears, EOS, Photovate und weitere), nutze diese. Sie ist fertig verdrahtet und wird unterstützt. Die API ist für alles andere da: Eigenentwicklungen, BI-Tools, Nischen-CRMs, eigene Dashboards und Brücken zu Tools ohne benannte Integration. Für No-Code-Automatisierungen und ausgehende Ereignis-Pushes siehe die Artikel zu Zapier und Webhooks.

Für wen dieser Artikel ist

Installateur-Admins und Workspace-Admins, die eigene Integrationen bauen oder Daten aus Reonic exportieren. Deine Endkunden (Eigentümer, gewerbliche Käufer) bekommen die API-Oberfläche nie zu sehen.

Bevor du startest

• Du brauchst Admin-Rechte in deinem Reonic-Workspace.
• Die API steht in jedem Workspace zur Verfügung. Wenn der Bereich für API-Keys in deinen Einstellungen nicht auftaucht, wende dich an den Reonic Support.
• Reonic betreibt für eine Übergangszeit eine aktuelle und eine vorherige API-Version parallel. Wenn dein Workspace Keys auf der älteren Version hat, zeigt die Seite Einstellungen > API / Developers > API für jede einen eigenen Reiter. Baue alle neuen Integrationen gegen die aktuelle Version.
• Einen Script-Host, ein BI-Tool oder irgendein System, das HTTPS-Anfragen senden kann.

Die Seite mit den API-Einstellungen finden

Die Konfiguration für API und Webhooks liegt auf einer anderen Einstellungsseite als die Liste der benannten Integrationen.

1. Öffne Einstellungen > API / Developers. Das ist nicht dasselbe wie Einstellungen > Firmeneinstellungen > Integrationen (die Seite der benannten Integrationen).
2. Die Kategorie API / Developers enthält zwei Seiten: API (Keys anlegen und verwalten) und Webhooks (ausgehende Webhooks und die Zapier-Hooks konfigurieren).
3. Wenn dein Workspace Keys auf der vorherigen API-Version hat, zeigt die Seite API einen Reiter für die aktuelle Version (vorausgewählt) und einen für die vorherige Version. Workspaces mit Keys ausschließlich auf der aktuellen Version sehen nur eine Seite.
4. Wenn du den Bereich für API-Keys überhaupt nicht siehst, wende dich an den Reonic Support.

Einen API-Key anlegen

Über API-Keys authentifizieren sich deine Skripte und externen Systeme gegenüber Reonic.

1. Klicke auf der Seite API auf API-Key neu erstellen.
2. Gib dem Key einen aussagekräftigen Namen, an dem du erkennst, wofür er da ist — etwa ein Nur-lesen-Key fürs Lager oder ein Zapier-Produktivkey. Der Name erscheint im Aktivitätsprotokoll, sodass du Keys auseinanderhalten kannst.
3. Wähle den Berechtigungsumfang. Es gibt drei: Nur lesen (Lesezugriff auf alle Ressourcen), Lesen und Schreiben (voller Lese- und Schreibzugriff auf alle Ressourcen) und Nur Lead-Erstellung (ein eingeschränkter Umfang, der Leads, Haushaltsprojekte, Kontakte und Notizen anlegen kann, sonst nichts). Für eine normale Integration wählst du Nur lesen oder Lesen und Schreiben. Nur Lead-Erstellung ist für eingehende Lead-Broker-Keys gedacht, die nur Leads hinzufügen sollen.
4. Reonic erzeugt den Key und zeigt ihn bei der Erstellung an.
5. Kopiere ihn sofort in deine sichere Zugangsdatenverwaltung und speichere dann. Wenn du den Key nicht mehr hast, lege einen neuen an und entferne den alten.

Wo du die Client-ID findest

Deine Client-ID ist die Kennung deines Workspace. Für die meisten Integrationen brauchst du sie nicht separat. Einige wenige Partner-Integrationen, etwa manche eingehenden Lead-Broker-Setups, erwarten die Client-ID als eigenes Feld. Lass dir deine vom Reonic Support bestätigen.

API-Key im Vergleich zur Client-ID

Der API-Key ist das Geheimnis, vergleichbar mit einem Passwort. Er authentifiziert jede Anfrage. Die Client-ID ist die Kennung deines Workspace, vergleichbar mit einem Benutzernamen. Halte den API-Key geheim; die Client-ID ist die Referenz deines Workspace für Partnersysteme.

API-Aufrufe authentifizieren

Reonic verwendet einen eigenen Authentifizierungs-Header statt des Standard-Headers Authorization. Die Endpunkt-Referenz nennt den genauen Header und zeigt, wie du ihn setzt.

1. Setze in deinem HTTP-Client den Reonic-Authentifizierungs-Header auf den Wert deines API-Keys.
2. Sende die Anfrage an den passenden Endpunkt.
3. Wird die Anfrage als nicht authentifiziert abgelehnt, prüfe, ob du den Reonic-Authentifizierungs-Header gesetzt hast (nicht den Standard-Header Authorization) und ob du den vollständigen Key kopiert hast.

Die Endpunkt-Referenz finden

Die Endpunkt-Referenz ist eine gerenderte Dokumentationsseite. Sie ist die maßgebliche Liste aller Endpunkte mit ihrem genauen Pfad, den Request- und Response-Feldern und dem Authentifizierungs-Header. Ihre Endpunkte verteilen sich auf zehn große Bereiche:

• Personen — Nutzer, Teams.
• Projekte — Haushaltsprojekte (die Haushaltsoberfläche für Photovoltaik, Wärmepumpe und Wallbox) und Gewerbliche Projekte (die gewerbliche Pipeline).
• Arbeit an einem Projekt — Aktivitäten, Status, Tags, Notizen, Dateien, Kanban-Boards und -Spalten.
• Kalender — Termine, Kalender-Feeds.
• Katalog — Komponenten, Hersteller, Planungspakete, Planungsvorlagen, Angebotsvorlagen.
• Workspace-Einrichtung — Leadquellen, Checklistenvorlagen, Integrationen.
• Wiki — Wiki-Inhalte.
• Leistungen — Servicetermine.
• API-Helfer — Hilfsendpunkte.
• Anleitungen — eingebettete Seiten des Migrationsleitfadens.

Deinen ersten API-Aufruf machen

Teste die Verbindung, bevor du etwas darauf aufbaust.

1. Wähle einen risikoarmen Leseendpunkt. Eine Liste der Haushaltsprojekte oder der Kontakte ist ein sicherer Anfang. Den genauen Pfad gibt dir die Endpunkt-Referenz.
2. Setze den Aufruf ab, mit deinem API-Key im Reonic-Authentifizierungs-Header.
3. Reonic antwortet mit einem JSON-Payload. Listen-Endpunkte liefern ein Daten-Array plus einen Paginierungsblock.
4. Prüfe unter Einstellungen > Firmeneinstellungen > Integrationen, dass der Aufruf mit Erfolgsstatus angekommen ist.

Auf die aktuelle API-Version migrieren

Während der Übergangszeit laufen beide API-Versionen parallel, und die vorherige Version bleibt stabil. Plane deine Migration frühzeitig, damit deine Integrationen deutlich vor der Abschaltung der vorherigen Version auf der aktuellen laufen. Frag den Reonic Support nach dem geplanten Abschaltdatum, damit du danach planen kannst.

Die Gruppe migration in der Endpunkt-Referenz führt durch die Schritte. Kurz gefasst:

1. Lege einen neuen Key an auf der aktuellen Version. Aktuelle Endpunkte erwarten einen Key der aktuellen Version.
2. Verarbeite paginierte Listen. Jede Listenantwort umschließt ein Daten-Array plus einen Paginierungsblock. Passe jeden Parser an, der von einem blanken Array ausging.
3. Nutze die Oberflächen für Haushaltsprojekte und Gewerbliche Projekte. Sie ersetzen die ältere Oberfläche aus Anfragen und Angeboten: Haushaltsprojekte für die Linie Photovoltaik, Wärmepumpe und Wallbox, Gewerbliche Projekte für die gewerbliche Linie.
4. Stelle auf die aktuellen Feldnamen um. Einige Feldnamen unterscheiden sich von der vorherigen Version, darunter die Felder für E-Mail, Adresse und Varianten. Die Endpunkt-Referenz listet die aktuellen Namen auf.
5. Übernimm die aktuellen Limits und das aktuelle Caching-Verhalten. Die Endpunkt-Referenz beschreibt, wie du pro Aufruf einen frischen Lesevorgang anforderst und wie du reagierst, wenn du gebeten wirst, langsamer zu werden (siehe Rate-Limits und Caching handhaben).

Um Objekte nachzubauen, die du früher mit den älteren Duplizier-Helfern erzeugt hast, nutze den Standard-Endpunkt zum Anlegen. Die aktuelle Version bildet das Duplizieren über den normalen Anlegevorgang ab.

Paginieren, filtern und Deltas abrufen

Listen-Endpunkte nutzen seitennummernbasierte Paginierung.

• Übergib eine Seitennummer und eine Seitengröße, um durch die Ergebnisse zu blättern.
• Die Antwort enthält Links zur nächsten und zur vorherigen Seite. Folge ihnen, um den ganzen Satz durchzublättern.
• Ein paar Endpunkte paginieren anders. Die Endpunkt-Referenz weist auf diese Fälle hin, darunter eine feste Seitengröße bei der Zeiterfassung, Endpunkte mit einer einzigen Antwort wie Teams und Tags sowie ein gleitendes Zeitfenster bei Kalenderterminen.

Für Delta-Abrufe (nur Datensätze, die sich seit deinem letzten Lauf geändert haben) liefern Haushaltsprojekte einen Zeitstempel der letzten Bearbeitung, den du als Höchstmarke nutzen kannst. Bei anderen Endpunkten merkst du dir den höchsten Änderungszeitstempel aus der vorherigen Antwort und holst ab dort neu. Wie gut Filter für „geändert seit“-Abfragen unterstützt werden, hängt vom Endpunkt ab. Wenn dein Skript Delta-Unterstützung braucht, frag den Reonic Support, welche Listen-Endpunkte den Filter anbieten.

Rate-Limits und Caching handhaben

Die API wendet pro Workspace ein Rate-Limit an, damit keine einzelne Integration deine Daten überlastet. Wenn du Anfragen schneller sendest als erlaubt, antwortet Reonic mit der Bitte, langsamer zu werden.

1. Wirst du gebeten, langsamer zu werden, warte ab, bevor du es erneut versuchst. Exponentielles Backoff (2, 4, 8, 16 Sekunden) ist ein sicheres Muster.
2. Meldet der Dienst, dass er vorübergehend nicht verfügbar ist, warte ab und versuche es erneut.
3. Bei großen Abrufen taktest du deine Aufrufe und legst eine kurze Pause zwischen den Seiten ein, um unter dem Limit zu bleiben.
4. Wiederholte Lesevorgänge werden aus einem kurzlebigen Cache bedient. Wenn du bei einem bestimmten Aufruf die allerneuesten Daten brauchst, zeigt die Endpunkt-Referenz, wie du einen frischen Lesevorgang anforderst.

Fehler behandeln

Reonic gibt strukturierte HTTP-Fehler zurück, die auf die üblichen 4xx- und 5xx-Semantiken abgebildet sind.

• Nicht authentifiziert — fehlender oder ungültiger Key. Prüfe, ob du den Reonic-Authentifizierungs-Header gesetzt hast (nicht den Standard-Header Authorization) und den vollständigen Key kopiert hast.
• Zugriff verweigert — der Berechtigungsumfang des Keys deckt die Operation nicht ab, oder die Ressource liegt außerhalb dessen, was der Key erlaubt. Behandle 4xx-Antworten als endgültig; wiederhole sie nicht.
• Nicht gefunden — prüfe die ID.
• Bitte langsamer — du sendest Anfragen zu schnell. Warte ab und versuche es erneut.
• Serverfehler (5xx) — melde ihn dem Support mit dem Zeitstempel. Behandle 5xx als vorübergehend und wiederhole mit Backoff.
• Vorübergehend nicht verfügbar — warte ab und versuche es erneut.

Häufige API-Aufgaben

Das sind die am häufigsten gefragten Muster. Nimm sie als Ausgangspunkt. Die aktuelle Endpunkt-Referenz listet jeden Endpunkt und seine genauen Feldstrukturen auf; wenn du nicht weiterkommst, hilft dir dein Kundenbetreuer.

Eine Anfrage erstellen

Nutze den Anlege-Endpunkt für Haushaltsprojekte für Leads zu Photovoltaik, Wärmepumpe und Wallbox und den Anlege-Endpunkt für Gewerbliche Projekte für die gewerbliche Pipeline. Der Endpunkt gibt die ID des neuen Projekts zurück.

Damit der Lead auf der Karte landet, braucht Reonic einen Standort. Übergib eine Adresse, die Reonic nachschlägt, oder einen Satz Koordinaten, den du bereits aufgelöst hast. Gib immer eine Postleitzahl mit und prüfe die zurückgegebenen Koordinaten, wenn es auf punktgenaue Lage ankommt.

Setze den Projektstatus schon beim Anlegen, wenn du einen bestimmten Startstatus willst. Andernfalls landet die Anfrage auf dem Startstatus des Workspace.

Über diesen Endpunkt importierst du auch Leads aus einem System ohne benannte Integration, zum Beispiel aus einem WordPress-Kontaktformular, das auf deinen Endpunkt für Haushaltsprojekte oder Kontakte postet. Der Weg mit dem wenigsten Code ist eine Zapier-Brücke vom WordPress-Formular aus.

Eine Anfrage nach dem Anlegen bearbeiten

Die meisten Felder kannst du nach dem Anlegen aktualisieren, auch die Adresse — über den Update-Endpunkt für Haushaltsprojekte oder Gewerbliche Projekte und die Projekt-ID.

Ein Angebot aus einem Projekt erstellen

Ein Angebot in der API ist die bepreiste, variantenförmige Offerte, die an ein Projekt hängt. Es bündelt eine oder mehrere Varianten (jede mit eigener Komponentenliste, Paketauswahl, Preisgestaltung und optionalem Rabatt- oder Finanzierungsaufbau) plus die Metadaten auf Angebotsebene (Status, Unterschriftsstand, angehängte Notizen und Dateien). Es ist dasselbe Konstrukt, das du im Portal unter dem Reiter Angebote eines Projekts siehst.

Der empfohlene Ablauf:

1. Erstelle das Projekt über die API.
2. Nimm die Projekt-ID aus der Antwort.
3. Rufe den Endpunkt zum Anlegen des Angebots mit dieser Projekt-ID und deiner Variantendefinition auf.
4. Die Antwort enthält die ID des neuen Angebots, die du für spätere Aktualisierungen nutzt.

Lass den Status des Angebots beim Anlegen leer, wenn es als Entwurf landen soll. Um eine Anfrage in ein Angebot umzuwandeln, rufst du den Endpunkt zum Anlegen des Angebots mit der Projekt-ID auf; Reonic verknüpft das neue Angebot dann mit dem Ausgangsprojekt.

Einen Angebotspreis über die API setzen oder ändern

Der Update-Endpunkt für Angebote akzeptiert einen Preis auf Variantenebene, was hilfreich ist, wenn dein externes Preissystem einen Endpreis nach Reonic schreiben muss. Die genaue Feldstruktur hängt von der Variante ab. Schau in die Endpunkt-Referenz oder frag den Reonic Support.

Notizen oder Dateien an ein Angebot hängen

Es gibt eigene Endpunkte, um eine Notiz hinzuzufügen und um eine Datei hochzuladen. Hochgeladene Dateien (PDFs, Bilder) hängen an dem Angebot, Projekt oder Kontakt, den du ansteuerst.

Einen Kontakt erstellen

Nutze den Anlege-Endpunkt für Kontakte. Beim Anlegen von Kontakten sind Koordinaten nicht erforderlich; nur Projekte, die auf der Karte erscheinen, brauchen einen Standort.

Für Massenimporte (eine bestehende Kontaktliste aus einer CSV, einem alten CRM oder einer Tabelle nach Reonic migrieren) durchläufst du deine Datensätze und legst pro Aufruf einen Kontakt an; takte die Aufrufe so, dass du unter dem Rate-Limit bleibst. Für größere einmalige Migrationen lässt du die Schleife aus deiner eigenen Infrastruktur gegen denselben Endpunkt laufen. Jeder Anlege-Endpunkt gibt die ID der neuen Ressource zurück — nimm sie also gleich beim Anlegen mit.

Aktivitäten nach Elterntyp filtern

Der Endpunkt für Aktivitäten unterstützt einen Filter nach Elterntyp, der Aktivitäten auf eine bestimmte Art von übergeordnetem Datensatz einschränkt, zum Beispiel ein Haushaltsprojekt, ein Gewerbeprojekt, ein Paket, eine Komponente, einen Kontakt, einen Photogrammetrie-Job oder einen Nutzer. Die genau akzeptierten Werte stehen in der Endpunkt-Referenz.

Daten exportieren

Der sauberste Weg für einen Massenexport ist, den passenden Endpunkt mit Paginierung aufzulisten und die Antwort zu speichern. Häufige Ziele:

• Gewonnene Angebote — alle Angebote abrufen und nach Status filtern, oder die Liste zum Status Gewonnen abrufen.
• Kontakte — Kontakte mit Paginierung abrufen und lokal speichern.
• Gewerbliche Projekte — Gewerbliche Projekte abrufen.
• Termine — Termine für die Reonic-Kalenderoberfläche abrufen. Externe Microsoft- oder Google-Kalender rufst du direkt bei diesen Diensten ab.
• Komponentenversionen — Komponenten abrufen und dort, wo es Versionen gibt, nach übergeordneter Komponente gruppieren.
• Kanban-Stand — Kanban-Boards und -Spalten für Momentaufnahmen der Projekt-Boards abrufen.
• Leadquellen — Leadquellen für die konfigurierte Lead-Kanal-Systematik des Workspace abrufen.

Um eine Excel-Datei mit deinen Anfragen, Angeboten, Statistiken oder Rohdaten zu erzeugen, rufst du den passenden Listen-Endpunkt ab und lädst die JSON-Antwort in Excel, Google Sheets oder dein BI-Tool.

Für externe Integrationen die aktuelle API-Version nutzen

Baue externe Integrationen immer gegen die aktuelle öffentliche API-Version, auch Datei-Uploads. Sie ist der stabile, unterstützte Vertrag, um deine Daten von außerhalb des Portals zu lesen und zu schreiben.

Brücken zu Tools ohne benannte Integration

Für Systeme, die nicht im Katalog der benannten Integrationen stehen (Datev, Monday.com, Craftnote, Office-365-Kontaktabgleich, Zoho CRM, Massen-E-Mail), baust du gegen die API, um Daten nach Zeitplan hinauszuschieben, oder verdrahtest sie über Zapier.

• Datev — Rechnungen über die API aus Reonic hinausschieben und auf der Buchhaltungsseite in Datev importieren, oder Lexoffice bzw. Sevdesk als Brücke nutzen (beide haben einen nativen Datev-Export). Über Lexoffice oder Sevdesk bindest du auch ein Steuerbüro an, das typischerweise ohnehin Zugriff auf eines dieser Tools hat.
• Office-365-Kontaktabgleich — die Microsoft-Integration kümmert sich um Kalender; Kontakte gleichst du mit einem eigenen Zap oder einer API-Integration gegen deinen Kontakte-Endpunkt ab.
• Massen-E-Mail — Reonic ist kein E-Mail-Marketing-Tool. Exportiere deine Kontakte über die API und verschicke die Kampagne über eine spezialisierte Plattform (Mailchimp, Brevo, HubSpot Marketing).
• Zoho CRM — überbrücke es mit einem Zapier-Ablauf (ein Trigger Zoho CRM new-lead, der auf deinen Endpunkt für Haushaltsprojekte oder Kontakte postet), oder skripte eine regelmäßige Synchronisierung von Zoho nach Reonic in deiner eigenen Infrastruktur. Beide Wege brauchen die Adressfelder, die unter Eine Anfrage erstellen beschrieben sind.
• Microsoft 365 / Google Workspace Kalender — dafür gibt es eigene Integrationen unter Einstellungen > Firmeneinstellungen > Integrationen, nicht den API-Weg. Richte sie dort ein und rufe externe Outlook- oder Google-Kalender dann direkt bei diesen Diensten ab. Die API stellt die Reonic-Termine bereit.
• Lead-Broker (AroundHome, DAA, Wattfox und andere) — dafür gibt es eigene benannte Integrationen unter Einstellungen > Firmeneinstellungen > Integrationen, nutze also diese statt der generischen API. Bei AroundHome ist die Kunden-ID die integrationsspezifische Kennung; das genaue Format findest du im AroundHome-Adminbereich. Auf API oder Zapier weichst du nur für Leadquellen außerhalb des benannten Katalogs aus.

Wenn du für eine Quelle mit hohem Volumen eine benannte Integration möchtest, sprich deinen Kundenbetreuer darauf an.

Wo die benannten Integrationen liegen

Alle benannten Integrationen liegen unter Einstellungen > Firmeneinstellungen > Integrationen (nicht unter API / Developers), jede mit eigener Einrichtungsseite und eigenen Zugangsdaten pro Workspace. Für die Finanzierung über Bees & Bears brauchst du keinen API-Key. Konfiguriere die Integration direkt unter Einstellungen > Firmeneinstellungen > Integrationen, um die Zugangsdaten kümmert sich Reonic.

• HubSpot, Photovate, Hero, Sevdesk — siehe ihre Einrichtungsseiten unter Einstellungen > Firmeneinstellungen > Integrationen.
• Angebotsexport zu Photovate / K2 und Photovate-Komponentenverknüpfung — eigene Export-Schaltflächen auf dem unterschriebenen Angebot. Bei Angeboten, die nach der Unterschrift K2-Daten brauchen, klickst du auf die Export-Schaltfläche in der Unterschriftszeile.
• Finanzierung (Bees & Bears, EOS) — Bees & Bears deckt DE, AT, FR und BE ab; EOS deckt Brasilien ab. Nachdem ein Kunde ein Angebot mit Finanzierungsoption unterschrieben hat, nutzt du auf dem unterschriebenen Angebot die Schaltfläche für den Export an den Finanzierungspartner. Reonic sendet die Angebotsdaten, die Kundendetails und das unterschriebene PDF an den Finanzierungspartner. Erscheint die Exportoption nicht, kläre mit deinem Kundenbetreuer, ob die Finanzierungsintegration für deinen Workspace aktiviert ist und ob der Nutzer das Recht Finanzierungsanbieter hat.
• Sevdesk nach einem abgelaufenen Link — um ein unterschriebenes Angebot an Sevdesk zu übergeben, wenn der ursprüngliche Unterschriftslink abgelaufen ist, stellst du für dieselbe Variante eine neue Unterschriftsanfrage aus, lädst das unterschriebene PDF in die neue Unterschriftszeile hoch und klickst dann in dieser Zeile auf die Sevdesk-Export-Schaltfläche.
• SMTP — Reonic versendet kundengerichtete E-Mails wie Unterschriftslinks und Rechnungsbenachrichtigungen. Um von deiner eigenen Domain aus zu senden, konfigurierst du einen eigenen ausgehenden SMTP-Server unter Einstellungen > Firmeneinstellungen > Integrationen > SMTP-Mailserver.
• Kontaktformularfelder und UTM — das Kontaktformular unterstützt eine begrenzte Auswahl zusätzlicher Felder und Leadquellen-Tags. Die UTM-Durchreichung bei eingebetteten Formularen übernimmt der Einbettungscode; sprich mit deinem Kundenbetreuer über UTM-Tracking für das Kontaktformular.

Angebote zwischen Reonic-Workspaces übertragen

So verschiebst du ein Angebot zwischen Reonic-Workspaces:

1. Exportiere das Angebots-PDF aus dem Quell-Workspace.
2. Lege Projekt und Angebot im Ziel-Workspace neu an, entweder über die API oder manuell im Portal.
3. Hänge das exportierte PDF als Datei an das Angebot im Ziel-Workspace.

Wenn das regelmäßig vorkommt, etwa bei einer Franchise-Gruppe, die Angebote über Workspaces hinweg verschiebt, sprich mit deinem Kundenbetreuer über ein besseres Muster.

Gut zu wissen

• Die API steht in jedem Workspace zur Verfügung. Die Keys erscheinen auf der Seite Einstellungen > API / Developers > API.
• Während der Übergangszeit laufen beide API-Versionen parallel. Baue neue Integrationen gegen die aktuelle Version und migriere, bevor die vorherige abgeschaltet wird; frag den Reonic Support nach dem Zieldatum.
• Reonic verwendet einen eigenen Authentifizierungs-Header, nicht den Standard-Header Authorization. Viele HTTP-Clients setzen standardmäßig Authorization; füge stattdessen den Reonic-Authentifizierungs-Header als eigenen Header hinzu. Die Endpunkt-Referenz nennt ihn.
• Die Endpunkt-Referenz ist der maßgebliche Vertrag. Sie listet jeden Endpunkt, seinen genauen Pfad, die Request- und Response-Felder und den Authentifizierungs-Header auf. Wenn ein Feld oder Pfad von der vorherigen Version abweicht, zeigt die Referenz den aktuellen Namen.
• Berechtigungsfehler erscheinen als strukturierte HTTP-Fehler. Behandle 4xx als endgültig (nicht wiederholen), 5xx als vorübergehend (mit Backoff wiederholen).
• Kopiere jeden Key beim Anlegen in deine sichere Zugangsdatenverwaltung. Wenn du einen Key nicht mehr hast, lege einen neuen an und entferne den alten.
• Der Berechtigungsumfang eines API-Keys hat drei Stufen — Nur lesen, Lesen und Schreiben und Nur Lead-Erstellung (ein eingeschränkter Umfang, der nur Haushaltsprojekte, Kontakte und Notizen anlegen kann, für eingehende Lead-Broker-Keys). Lege für die Nachvollziehbarkeit getrennte Keys mit aussagekräftigen Namen an.
• Rate-Limits gelten pro Workspace. Wenn du Anfragen zu schnell sendest, bittet Reonic dich, langsamer zu werden; warte ab und versuche es erneut. Alle Keys eines Workspace teilen sich ein Budget.
• Wiederholte Lesevorgänge werden aus einem kurzlebigen Cache bedient. Wenn du bei einem bestimmten Aufruf die neuesten Daten brauchst, zeigt die Endpunkt-Referenz, wie du einen frischen Lesevorgang anforderst.
• Wenn du einen Key entfernst, funktioniert er nicht mehr. Ein Key, der deaktiviert, rotiert oder gelöscht wird, ist außer Betrieb.
• Jeder API-Aufruf landet im Aktivitätsprotokoll der Integration mit deiner Client-ID, der Methode, dem Status und einem Zeitstempel, sichtbar unter Einstellungen > Firmeneinstellungen > Integrationen.
• Aktivitäten lassen sich nach Elterntyp filtern. Schränke Aktivitäten auf ein Haushaltsprojekt, ein Gewerbeprojekt, ein Paket, eine Komponente, einen Kontakt, einen Photogrammetrie-Job oder einen Nutzer ein; die genauen Werte stehen in der Endpunkt-Referenz.
• Externe Kalender laufen nicht über die API. Die API stellt die Reonic-Termine bereit; Outlook oder Google rufst du direkt bei diesen Diensten ab.
• Teste gegen deinen Workspace mit einer klar benannten Testanfrage und räume sie anschließend wieder auf.

Zuletzt aktualisiert am 30. September 2026