onOffice API-Zugang erstellen
Um Objekte aus onOffice in MaklerEngine zu importieren, benötigst du API-Zugangsdaten (Token und Secret) aus deinem onOffice enterprise-Konto.
Voraussetzungen
Ein aktives onOffice enterprise-Konto mit Administratorzugang
Berechtigung zur Verwaltung von API-Benutzern
Schritt-für-Schritt-Anleitung
Bei onOffice einloggen
Melde dich in deinem onOffice enterprise-Konto an.
Administration öffnen
Navigiere zu Extras → Einstellungen → Benutzerverwaltung. Alternativ findest du den Bereich unter Administration → API-Benutzer.
API-Benutzer erstellen
Erstelle einen neuen API-Benutzer. Vergib einen sprechenden Namen wie „MaklerEngine". Stelle sicher, dass der Benutzer Lesezugriff auf Immobilien (Estates) hat.
Token und Secret kopieren
Nach dem Erstellen erhältst du zwei Werte:
- API-Token — Ein 32-stelliger Schlüssel zur Identifikation
- API-Secret — Ein 64-stelliger geheimer Schlüssel zur Signierung
Kopiere beide Werte sofort, da das Secret danach nicht mehr einsehbar ist.
In MaklerEngine einfügen
Gehe in MaklerEngine zu Einstellungen → Integrationen → CRM-Systeme. Füge Token und Secret in die onOffice-Felder ein und klicke auf Speichern.
Verbindung testen
Klicke auf „Verbindung testen" um sicherzustellen, dass die Zugangsdaten korrekt sind. Bei Erfolg ist dein onOffice-Konto verbunden.
Sicherheitshinweis
Dein API-Token und Secret werden verschlüsselt (AES-256) auf unseren Servern gespeichert und niemals im Klartext übertragen oder angezeigt. Die Verbindung kann jederzeit in den Einstellungen getrennt werden, wodurch die gespeicherten Zugangsdaten unwiderruflich gelöscht werden.
Wie funktioniert die Authentifizierung?
onOffice verwendet eine HMAC-SHA256-basierte Authentifizierung. Das bedeutet:
Dein Secret wird niemals direkt an onOffice gesendet. Stattdessen wird jede Anfrage mit einer einmaligen Signatur versehen.
Alle API-Aufrufe laufen über unsere Server — dein Browser kommuniziert nicht direkt mit onOffice.