Zum Hauptinhalt springen

Einleitung

EstateSync erlaubt die einfache Verteilung von Immobiliendaten zu verschiedenen deutschen Immobilienportalen. Mit einem Request sind neue Anzeigen blitzschnell überall online.

Wenn Apps zur Verwaltung von Immobilien gebaut werden, müssen neue Angebote meist auf ImmoScout24, Immowelt, Kleinanzeigen oder anderen Portalen veröffentlicht werden. Manche dieser Portale haben eine eigene API, manche nutzen OpenImmo. Manche benötigen veraltete FTP Server zur Datenübertragung, andere komplizierte OAuth Authentifizierungs-Mechanismen.

EstateSync ist die Ebene zwischen Immobiliensoftware und Portalen, welche sich um die Umformung der Daten kümmert. So muss nur eine Schnittstelle implementiert werden, und nicht für jedes Portal eine eigene.

Kleines Glossar

EstateSync nutzt ein paar Begriffe, welche ein Objekt in der API eindeutig identifizieren. Die folgenden tauchen häufiger auf:

Account

Ein Account repräsentiert einen Zugang zur API. Er beinhaltet alle erstellten Objekte, aber auch Einstellungen zur Administration oder Abrechnung. Beim Registrieren wird automatisch ein neuer Account angelegt. Wir empfehlen, einen Account für die lokale Entwicklung und einen separaten Account für das Live-System zu verwenden.

Property

Ein Property repräsentiert die Immobilie als physisches Objekt — mit Typ, Feldern wie Adresse und Ausstattung sowie Anhängen.

Target

Ein Target repräsentiert die Verbindung zu einem Portal wie Kleinanzeigen oder ImmoScout24. Auf diese Zielplattformen sollen verschiedene Properties veröffentlicht werden.

Listing

Ein Listing repräsentiert eine Anzeige, also eine Veröffentlichung eines Property auf einem Target. Das Erstellen eines Listings führt demnach zur Erstellung einer Anzeige auf einem Target. Wenn ein Property verändert wird, während es aktive Listings davon gibt, werden die entsprechenden Anzeigen automatisch angepasst. Die Zielplattformen stellen so immer die aktuelle Version von einem Property dar. Das Löschen eines Listings führt zur Deaktivierung der Anzeige auf dem entsprechenden Target.

Contact

Ein Contact repräsentiert eine Ansprechperson für ein oder mehrere Properties. Meist werden die Kontaktdaten der Ansprechperson (Name, Telefon, E-Mail, ...) neben der Anzeige dargestellt.

Request

Ein Request repräsentiert eine Kontaktanfrage, die durch eine interessierte Person auf einer Plattform (Target) abgesendet wurde. Diese Anfrage beinhaltet Details zur Person, die Interesse bekundet und meist eine Nachricht.