API - Autenticazione

L'autenticazione è il primo passo prima di utilizzare qualsiasi endpoint dell'API di Lengow. Deve essere effettuata ad ogni connessione.

Su questa pagina descriveremo i passaggi che devi seguire per assicurarti che la tua applicazione possa autenticarsi con l'API di Lengow. Utilizziamo Postman per i nostri esempi e descrizioni.
 

Passaggio 1: Credenziali del cliente

Qualsiasi partner che desidera interagire con l'API di Lengow avrà bisogno di un set di credenziali (un ID account Lengow, un token di accesso e un clientSecret), che possono essere trovati attraverso la dashboard di Lengow.

Dove trovare queste chiavi API in Lengow:

  • Accedi al tuo account Lengow
  • Apri la pagina delle impostazioni dal tuo profilo > "Informazioni generali"
  • Trova la sezione chiamata "A.P.I".  my.lengow.io/company/api 
  • Puoi copiare il token di accesso e il segreto visualizzati in questa sezione (vedi immagine sotto)

credentials.png

Hai bisogno di rinnovare le tue chiavi API Lengow?

Per ottenere un nuovo token di accesso e un nuovo segreto, basta cliccare sul pulsante "Rinnova" presente su questa pagina (vedi screenshot).
Se stavi utilizzando queste chiavi API da parte tua, ricorda di sostituire quelle obsolete.
 renew.png

Passaggio 2: Acquisizione di un token di accesso

Il passo successivo è acquisire un token di accesso dal nostro servizio di autenticazione e impostarlo come un Intestazione di autorizzazione quando si effettuano chiamate all'API di Lengow.

1.Configura il tuo ambiente di identificazione in Postman

Per richiedere un token, inizia creando l'intestazione di autorizzazione.

  • Per farlo, completa le tue credenziali del cliente utilizzando Postman e crea il tuo ambiente.

2.Richiesta del token di accesso

Dopo aver impostato l'intestazione di autorizzazione, richiedi un token effettuando un POST:

POST /access/get_token

Il server restituisce una risposta come questa: 

{
"token": "1895caa9-94d3-4ff6-ac9a-5b74a0e5a1b7", 
"account_id": 1
}

3. Completa l'ambiente di identificazione con il token di accesso 

Apri di nuovo il tuo ambiente in Postman e aggiungi una nuova variabile '"LENGOW_AUTH" con il token generato (vedi immagine - fonte: Postman)

auth_step2.png

Nota: Se le credenziali non sono state fornite correttamente, riceverai una risposta 401 Non autorizzata dal server.  

Una volta ottenuto il tuo token, tutte le tue richieste API avranno bisogno di un'intestazione di autorizzazione attiva (Utilizza l'ambiente che hai creato in Postman per esempio).

Questo token che generi ad ogni nuova sessione sarà necessario per qualsiasi richiesta che invii all'API. Ogni token ha una durata di 3600 secondi.  
Per favore non richiedere un nuovo token per ogni richiesta all'API di Lengow! I token sono validi per periodi di tempo più lunghi e sono destinati ad essere riutilizzati. Non farlo può sovraccaricare il servizio di autenticazione e porterà a un ban IP quando i limiti di richiesta sono superati. Nota che i limiti di velocità per il servizio di autenticazione sono molto più bassi di quelli dell'API di Lengow.
D'accord, veuillez me fournir le texte à traduire.
Questo articolo è stato tradotto automaticamente. In caso di dubbio, faccia riferimento alle versioni originali in inglese o in francese.

Articoli in questa sezione

I nostri orari di assistenza
Dan Lunedì al Venerdì dalle ore 9:00 alle ore 6:30