You are here: Home / API-Modulo

API-Modulo

Questo modulo è un modulo aggiuntivo a pagamento e potrebbe non essere incluso nella versione di onOffice enterprise selezionata. Contatta il tuo referente commerciale.

Utilizzando l’API di onOffice, è possibile leggere e modificare i dati relativi al contatto e all’immobile in onOffice enterprise, ad esempio utilizzando il plugin“onOffice for WP-Websites” per i siti Wordpress.

Una volta attivata l’API, è necessario creare un utente (utente API) per utilizzare l’API.

Creare un utente API

Nell’elenco degli utenti in Extra>> Impostazioni >> Utenti , creare un nuovo utente tramite l’icona “Nuovo record di dati” nell’angolo in alto a sinistra.

Selezionare “Utente API” nel campo “Salva come:”.

Compilare il campo “Nome utente”, altrimenti non sarà possibile salvare i dati. Si prega di controllare attentamente il nome dell’utente, poiché non può essere modificato una volta creato.

Al momento della creazione non è possibile inserire ulteriori dettagli. Una volta salvato, l’utente viene creato e aperto direttamente per ulteriori modifiche.

Generare il token e il secret API

Una volta creato l’utente API, mancano ancora il secret e il token API. Questi sono necessari affinché, ad esempio, i creatori di siti web possano accedere ai dati relativi al contatto e all’immobile in onOffice enterprise.

Cliccare qui sull’icona “Aggiorna” per generare il token e il secret API.

Se è già stato generato un token API, il vecchio token API viene invalidato.

Prendi subito nota del nuovo secret , perché verrà visualizzato una sola volta!

Diritti dell’utente API

Nella scheda “Diritti” si determinano i diritti concessi all’utente.

All’utente API devono essere concessi i diritti necessari per la programmazione/le azioni desiderate.

In generale, i diritti dell’utente si applicano come altrove in onOffice enterprise .

Impostare “visualizzare immobili” su “tutti” (1). Si consiglia di deselezionare le caselle “Può vedere solo gli immobili pubblicati sul sito web” (2) e “Può vedere solo contatti pubblicati sul sito web” (3).

Il nostro plugin per WordPress visualizza solo gli immobili che sono stati pubblicati per il sito web. Le modalità di attivazione degli immobili per il sito web sono illustrate nella seguente sezione “autorizzazione immobili”.

Se si seleziona la casella “Può vedere solo gli immobili pubblicati sul sito web” (2), alcune funzioni come i moduli per i proprietari non funzioneranno completamente nel nostro plugin. Ad esempio, il plugin può creare immobili, ma non sono pubblicati per impostazione predefinita e quindi non sono più visibili al plugin. Il collegamento con il proprietario non può più essere stabilito. Si consiglia pertanto di deselezionare questa casella per il plugin.

Selezionando “Può vedere solo contatti pubblicati sul sito web” (3), è possibile stabilire se è necessario attivare esplicitamente gli indirizzi per farli apparire sul sito web. Se lo desideri, puoi spuntare la casella. Effettuare quindi le impostazioni aggiuntive descritte nella sezione successiva “pubblicazione contatti”.

Pubblicazione immobili

Gli immobili possono essere pubblicati nella vista dei dettagli dell’immobile>> scheda Commercializzazione.

Impostare l’opzione “Pubblica” nella categoria “Sito web proprio” su “Sì”.

Pubblicazione contatti

Per poter pubblicare gli indirizzi per l’utente API, è necessario selezionare quanto segue nell’amministrazione (Extra>> Impostazioni >> Amministrazione >> Campi di inserimento>> Modulo contatto>> Categoria Amministrazione) per attivare il campo “homepage_publish”.

Nella scheda, selezionare prima “Gestione contatti” per il modulo e “Amministrazione” per la categoria. Attivare il campo “homepage_veroeffentlichen”.

Ora è possibile pubblicare il record dei dati di contatto in contatti nella scheda “Dati di base” della categoria “Amministrazione”.