18.10 REST Webservice
REST Webservice Settings
NelleFrom impostazioni delthe CRM èsettings possibileits visionarepossible ito serviziview the available web disponibiliservices (quireferred riferitihere comeas webservice, oor REST webservice REST), perto farallow siexternal cheapplications unato applicazioneinteract esternawith possa interagire con ilthe CRM stesso,itself, sfruttandousing ilthe paradigmaREST RESTparadigm. UnA webservice èis accessibileaccessible tramiteby un indirizzoan URL address (quireferred riferitohere comeas endpoint), solitamenteusually formatomade dall'indirizzoby the URL dellaaddress installazioneof dithe vte,vte seguitoinstallation, dafollowed by /restapi/v1/vtews/, eand dalthe nomemethod delname metodoassociated associatoto all'the endpoint interessato.of interest.
UnaOnce voltaconfigured, configurato,it èis quindipossible possibileto tramiteinvoke richiestethe desired endpoint with HTTP invocarerequests endpointto specificiexecute perthe eseguirerequested l'azione richiesta.actions.
FormatoHTTP richiesterequests HTTPformat
Le richieste supportano unicamente il metodo POST e il tipo di autenticazione Basic, ossia il passaggio tra i campi header di Authorization definito come Basic <credenziali>, dove <credenziali> è la codifica in Base64 del nome utente e della accesskey, separati da :.
Le richieste ai webservice sono pensate per restituire una risposta in formato JSON: in caso di successo restituiscono uno stato e i dati elaborati dall'endpoint, mentre in caso di errore restituiscono il codice di errore e la relativa descrizione.
Selettore utente e visualizzazione accesskey, lista moduli e campi utilizzabili
Tramite l'apposita picklist, associata a Nome Utente, è possibile selezionare l'utente interessato; questo permette, tramite pulsanti appositi, di visualizzarne gli accesskey e i moduli accessibili per le richieste dall'utente selezionato.
Il pulsante associato a Webservice accesskey permette di mostrare, previo inserimento della propria password, gli accesskey generati dall'utente: questi vengono usati per autorizzare le richieste ai webservice, come osservato nel paragrafo Formato richieste HTTP. Da notare che per aggiungere ulteriori accesskey, l'utente deve accedere alle proprio preferenze, nella sezione Configurazione servizi web REST: si rimanda alla sezione dedicata alle preferenze utente.
Il pulsante associato a Lista di moduli e campi utilizzabili permette di visualizzare l'elenco dei moduli disponibili per l'utente e il loro nome interno, da usare nelle richieste ai webservice ove richiesto.
Pagina Documentazione REST (OpenAPI)
Cliccando il pulsante associato a Mostra Documentazione REST, è possibile accedere alla pagina adibita alla visualizzazione degli endpoint esposti dal CRM. Inizialmente vuota, basterà cliccare su Genera Documentazione OpenAPI per ottenere la definizione degli endpoint che verrà usata per la loro impaginazione.
E' quindi possibile testare i singoli endpoint premendo il pulsante Test Request per l'endpoint e l'utente interessato, posto nel riquadro di esempio adiacente alla descrizione del metodo. L'utente si può selezionare tramite l'apposito selettore, posto centralmente in alto nella pagina.
Configurazione Web service esterni per utilizzo nei processi
Nella pagina delle impostazioni è possibile aggiungere client web service esterni, basati su Zapier (si rimanda al capitolo dedicato), o impostazioni personalizzate.
Una volta configurati e attivati, tramite il pulsante Aggiungi Client Webservice, possono essere visionati nella sezione Lista webservice client configurati, e utilizzati nei processi.