Sie befinden sich hier: Home / Zusatzmodule / API-Modul

API-Modul

Über die onOffice-API können Sie Adress- und Immobiliendaten in onOffice enterprise auslesen und auch verändern – z.B. bei der Nutzung des „onOffice for WP-Websites“ Plugins für Wordpressseiten.

Bitte beachten Sie, das API-Modul und er API-Benutzer sind nicht Bestandteil von onOffice enterprise edition, können aber als ergänzendes Produkt zusätzlich erworben werden.

Bitte kontaktieren Sie dazu Ihren vertrieblichen Ansprechpartner.

Nach der Freischaltung der API muss für die Nutzung der API ein Benutzer (API-Benutzer) angelegt werden.

API-Benutzer anlegen

In der Listenansicht der Benutzer erstellen Sie über das Symbol Icon Neuer Datensatz „neuer Datensatz“ einen neuen Benutzer.

Benutzer anlegen

Im Feld „Speichern als:“ bitte „API-Benutzer“ auswählen.

Benutzer als API-Benutzer anlegen

Bitte füllen Sie das Feld „Benutzername“ aus, ein Speichern ist sonst nicht möglich. Kontrollieren Sie den Benutzernamen bitte genau, da dieser nach dem Anlegen nicht mehr geändert werden kann.

Weitere Angaben sind beim Anlegen nicht möglich. Nachdem Sie gespeichert haben, wird der Benutzer angelegt und direkt zur weiteren Bearbeitung geöffnet.

API-Token und Secret generieren

Nachdem der API-Benutzer angelegt wurde, fehlen noch das API-Secret und Token. Diese werden benötigt, damit z.B. Webseiten-Ersteller Zugriff auf die Adress- und Immobiliendaten in onOffice enterprise haben.

Neu erstellter API-Benutzer

Klicken Sie hier auf das Symbol aktualisieren „Aktualisieren“ um API-Token und Secret zu generieren.

Token und Secret für den API-Benutzer

Falls schon mal eine API-Token generiert wurde, wird das alte API-Token hiermit ungültig.

Bitte notieren Sie sich sofort das neue Secret, da es nur einmal angezeigt wird!

API-Benutzer Rechte

Auf dem Karteireiter „Rechte“ bestimmen Sie, welche Rechte der Benutzer eingeräumt bekommt.

Der API-Benutzer soll die Rechte bekommen, die für die gewünschte Programmierung / Aktionen notwendig sind.

Generell gelten die Benutzerrechte wie auch an anderen Stelle in onOffice enterprise .

Rechteeinstellungen für API-Benutzer

Für die Verbindung zu Wordpresseiten über das „onOffice for WP-Websites“ Plugin, kann die Berechtigung auf freigegebene Adressen/Immobilien eingeschränkt werden.

Dazu setzen Sie bitte ein Häkchen bei „Kann nur auf der Webseite veröffentlichte Adressen/Immobilien sehen“. Weitere Informationen dazu finden Sie im Abschnitt „Freigabe von Immobilien und Adressen“ weiter unten.

Freigabe von Immobilien und Adressen

Wenn das Recht „Kann nur auf der Webseite veröffentlichte Adressen/Immobilien sehen“ gesetzt ist, müssen Immobilien und/oder Adressen für den API-Benutzer freigegeben werden. Falls das Recht allerdings nicht gesetzt ist, wird die Freigabe von Immobilien und Adressen über die normalen Benutzerrechte (lesen/schreiben/löschen) geregelt.

Immobilien

Immobilien können freigegeben werden in der Immobiliendetailansicht >>  Karteireiter Vermarktung.
Vermarktung der Immobilie auf der eigenen Internetseite
Bitte setzten Sie in der Kategorie „Eigene Internetseite“ die Option „Veröffentlichen“ auf  „ja“.

Adressen

Damit Sie Adressen für den API-Benutzer freigeben können, müssen Sie in der Administration (Extras >> Einstellungen >> Administration >> Eingabefelder >> Modul Adressen >> Kategorie Verwaltung) das Feld „homepage_veroeffentlichen“ aktivieren.

Auf dem Karteireiter wählen Sie zunächst beim Modul „Adressverwaltung“ und bei Kategorie „Verwaltung“ aus. Aktivieren Sie hier bitte das Feld „homepage_veroeffentlichen“.

Adresse veröffentlichen in der Administration aktivieren

Jetzt können Sie in Adressen auf dem Karteireiter „Grunddaten“ in der Kategorie „Verwaltung“ den  Adressdatensatz freigeben.

Adresse auf Webseiten veröffentlichen

API-Modul