Offene API, Webhooks und Mini-Apps für die Immobilienverwaltung
Wo es keine fertige Verbindung zwischen Unitify und einem anderen System gibt, ist die offene API der Weg hinein. Es ist dieselbe Schnittstelle, die die Produkte selbst nutzen, mit öffentlicher Dokumentation.
Diese Seite behandelt die API, Webhooks, Mini-Apps und die Anmeldung über Ihren eigenen Dienst: was jedes leistet, wie der Zugang läuft und was projektbezogen eingerichtet wird.
Kurz gesagt
Die GraphQL-API, Webhooks, Mini-Apps und die Anmeldung über OpenID Connect funktionieren heute und sind öffentlich dokumentiert. Der API-Zugang gehört zum Pro-Tarif. Der Zugang für ein bestimmtes System oder einen Anbieter und die Arbeit, ihre Daten zuzuordnen, werden projektbezogen eingerichtet.
Wofür diese Anbindung da ist
Jedes System anbinden, das eine API aufrufen kann
Eine Hausverwaltungssoftware oder ein ERP, eine Zählerplattform, ein Chatbot oder Ihre eigene Software liest und schreibt Unitify-Daten.
Auf Änderungen reagieren
Webhooks melden Ihrem System, dass sich eine Anfrage oder ein Kontakt geändert hat, statt dass es immer wieder nachfragt.
Auf der Plattform aufbauen
Eine Mini-App bringt Ihren Dienst in den Verwaltungsbereich oder die Bewohner-App, sodass Nutzer Unitify nicht verlassen.
Welche Daten in welche Richtung fließen
Jede Zeile sagt, ob es heute funktioniert oder für Ihr Projekt eingerichtet wird.
- Funktioniert heute
Lesen und schreiben: GraphQL-API
Objekte, Wohnungen, Kontakte, Anfragen, Zählerstände und Neuigkeiten lassen sich abfragen, anlegen und ändern.
- Funktioniert heute
Ereignisse nach außen: Webhooks
Abonnements umfassen Anfragen, Kontakte, Organisationen und Dokumente, mit den Feldern und Filtern Ihrer Wahl.
- Funktioniert heute
Im Produkt: Mini-Apps
Ein Webdienst läuft im Verwaltungsbereich oder in der Bewohner-App und spricht über die Bridge-Bibliothek mit der Hauptanwendung.
- Funktioniert heute
Anmeldung: OpenID Connect
Ein Dienst mit OpenID Connect lässt seine Nutzer sich ohne zweites Passwort an der Unitify-API autorisieren.
- Projektbezogen eingerichtet
Zuordnen und die Verbindung bauen
Festlegen, welche Ihrer Felder welchen unserer entsprechen, und den Austausch für Ihr System bauen.
So kommen Sie an den Zugang
Die Dokumentation ist öffentlich. Tarif und Zugriffsrechte richten wir mit Ihnen ein.
- Funktioniert heute
Dokumentation lesen
Datenmodell, Autorisierung und Beispiele sind öffentlich.
API-Dokumentation öffnen - Funktioniert heute
Im Playground ausprobieren
Die Dokumentation enthält eine Schritt-für-Schritt-Anleitung zum Playground für erste Abfragen.
Playground-Anleitung öffnen - Funktioniert heute
Webhook-Adressen
Abonnements und Adressen richten wir ein. Fragen Sie, und wir tragen Ihre ein.
- Funktioniert heute
Mini-Apps
Mini-Apps nutzen die Bridge-Bibliothek, um mit der Hauptanwendung zu sprechen.
Bridge-Dokumentation öffnen - Funktioniert heute
Anmeldung über Ihren Dienst
Die Anmeldung über Ihren eigenen Dienst läuft über OpenID Connect.
So funktioniert die externe Anmeldung
Was Sie beisteuern
Den Anwendungsfall
Was Ihr System lesen oder schreiben muss und wie oft.
Eine Testorganisation
Eine Organisation, an der der Zugang erprobt wird, bevor er echte Daten berührt.
Eine Kontaktperson auf Ihrer Seite
Jemanden, der API-Dokumentation liest und einen Webhook empfangen kann.
Was nicht geht
- Der API-Zugang gehört zum Pro-Tarif. Die aktuellen Tarifdetails stehen auf der Preisseite.
- Kein SAML. Die Anmeldung über einen anderen Dienst, für Mitarbeiter oder Bewohner, läuft über OpenID Connect, und wir registrieren Ihren Dienst als Anbieter. SAML bieten wir nicht an.
- Die Anbindung an Ihr System ist ein Projekt. Die API macht sie möglich; Ihre Daten zuzuordnen und den Austausch zu bauen ist Arbeit, die wir mit Ihnen abstecken.
Offene API und Webhooks: Fragen
Gibt es eine öffentliche API?
Ja. Die API ist GraphQL, und ihre Dokumentation ist öffentlich: Datenmodell, Autorisierung, Beispiele und eine Playground-Anleitung.
Was kann ich lesen und schreiben?
Objekte, Wohnungen, Kontakte, Anfragen, Zählerstände, Neuigkeiten und mehr. Objekte werden auf dieselbe Weise gelesen, angelegt und geändert.
Gibt es Webhooks?
Ja. Abonnements umfassen Anfragen, Kontakte, Organisationen und Dokumente. Das Abonnement richten wir für Sie ein.
Kann mein eigener Dienst in Unitify laufen?
Ja, als Mini-App im Verwaltungsbereich oder in der Bewohner-App, über die Bridge-Bibliothek.
Können meine Nutzer sich mit den Konten meines Dienstes an der API anmelden?
Ja, wenn Ihr Dienst OpenID Connect bietet; wir registrieren Ihren Dienst als Anbieter. SAML bieten wir nicht an.
Ist der API-Zugang kostenlos?
Der API-Zugang gehört zum Pro-Tarif. Die aktuellen Tarifdetails stehen auf der Preisseite.
Weiterführend
Sagen Sie uns, welches System Sie nutzen
Starten Sie kostenlos mit einem Objekt, ohne Verpflichtung und ohne Gespräch. Oder buchen Sie eine Demo und nennen Sie die Systeme und Geräte, die angebunden werden sollen. Jedes bestätigen wir, bevor Sie sich entscheiden.