API Benutzer verwalten

Inhaltsverzeichnis

API-Benutzer anlegen
API-Token und Secret generieren
API-Benutzer Rechte

API-Benutzer anlegen

In der Listenansicht der Benutzer unter Extras >> Einstellungen >> Benutzer erstellen Sie über das Symbol „neuer Datensatz“ oben links einen neuen Benutzer.
Im Feld „Speichern als:“ bitte „API-Benutzer“ auswählen.

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.
Klicken Sie hier auf das Symbol „Aktualisieren“ um API-Token und Secret zu generieren.

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 .

Setzen Sie “Objekte lesen” auf “alle” (1). Wir empfehlen, die Häkchen bei “Kann nur auf der Webseite veröffentlichte Objekte sehen” (2) und bei “Kann nur auf der Webseite veröffentlichte Adressen sehen” (3) wegzulassen.

Unser WordPress-Plugin zeigt nur Immobilien an, die für die Website veröffentlicht wurden. Wie Sie Immobilien für die Website freischalten ist im folgenden Abschnitt “Freigabe von Immobilien” erklärt.

Wenn Sie das Häkchen bei „Kann nur auf der Webseite veröffentlichte Objekte sehen“ (2) setzen, dann funktionieren in unserem Plugin einige Funktionen wie Eigentümerformulare nicht vollständig. Z. B. kann das Plugin dann Immobilien anlegen, diese sind aber nicht für standardmäßig veröffentlicht und damit für das Plugin nicht mehr sichtbar. Dann kann die Verknüpfung zum Eigentümer nicht mehr hergestellt werden. Daher empfehlen wir, für das Plugin dieses Häkchen zu entfernen.

Mit dem Häkchen “Kann nur auf der Webseite veröffentlichte Adressen sehen” (3) stellen Sie ein, ob Sie auch Adressen explizit freigeben müssen, damit sie auf der Website erscheinen. Wenn Sie möchten, können Sie das Häkchen setzen. Treffen Sie dann zusätzlich die weiteren Einstellungen, die im später folgenden Abschnitt „Freigabe von Adressen“ beschrieben sind.

API-Modul