Introduzione

Ufficio Web mette a disposizione delle WebApi pubbliche con le quali è possibile interagire e scambiare dati.

Aggiungendo “/swagger” all’indirizzo principale di Ufficio Web è possibile visualizzare una sintetica documentazione tecnica delle chiamate disponibili.

Sono disponibili delle DLL .NET per comunicare facilmente con le Web Api (vedi articolo DLL Proxy per comunicare con WebApi pubbliche)

Prima del loro utilizzo, è necessario effettuare una prima chiamata di login dalla quale verrà restituito un token che dovrà essere allegato all’header delle chiamate successive come autenticazione (attenzione: il token ha una scadenza).
Di seguito le istruzioni per l’autenticazione.

Autenticazione tramite Client Credentials

La chiamata da effettuare prevede i seguenti parametri:

• Url: {indirizzo del portale}/api/token
• Tipo chiamata: POST
• Nel body della chiamata:
  

  CHIAVE	VALORE
  grant_type	client_credentials
  client_id	{client id}
  client_secret	{client secret}

Se l’autenticazione va a buon fine, verrà restituito un contenuto json nel quale vi sarà il token di autenticazione.

Chiamate autenticate

Per le chiamate successive è necessario inserire nell’header la chiave authorization impostando come valore la stringa Bearer {token}

Formato dei parametri data

Attenzione: i parametri data passati alle chiamate devono rispettare il formato yyyy-MM-ddThh:mm:ss