Autenticazione

In questa sezione viene illustrato come autenticarsi alla piattaforma GEL Proximity con un utenza Rete per usufruire delle funzionalità messe a disposizione.

Per autenticarsi alla piattaforma GEL Proximity è necessario essere in possesso delle chiavi di accesso generate in automatico dal sistema a seguito del completamento dell’integrazione da parte del team di GEL Proximity.

Nel caso non si sia in possesso delle chiavi di accesso è necessario contattare il supporto GEL Proximity per permettergli di effettuare l’integrazione. Per maggiori informazioni consultare la sezione Introduzione Rete.

Per effettuare qualsiasi richiesta alla piattaforma di GEL Proximity è necessario richiedere un token di accesso effettuando una chiamata API all’endpoint indicato.

Parametri

Endpoint gel-api-server/api/network/autenticate
Metodo POST
Encoding x-www-form-urlencoded

Request

Nome Tipo Obbl. Default Descrizione
networkCode string Si – Codice univoco della Rete
apiKey string Si – Secret Key della Rete 
{
  "networkCode": "NET_PW2E5I",
  "apiKey": "27at1waz-1r77-112e-945c-466zwq09kl67",
}

Response

Nome Tipo Descrizione
success boolean Esito della richiesta
message string Messaggio di risposta
data AccessToken Dati restituiti

AccessToken

Nome Tipo Descrizione
accessToken string Token di accesso
tokenType string Tipologia di token
expiresIn number Tempo di scadenza del token in secondi 
{
  "success": true,
  "message": "Operazione completata",
  "data": {
    "accessToken": "a8yRu.q8up0vYR6h35Yaq.0PGbT",
    "tokenType": "Bearer",
    "expiresIn": 3600
  }
}

Una volta ottenuto il token di accesso è necessario inserirlo nell’header di ogni richiesta che verrà effettuata alla piattaforma di GEL Proximity.

Il token di accesso ha una scadenza indicata dal parametro expiryDate restituito dall’API di generazione del token stesso. Una volta che il token di accesso è scaduto sarà necessario richiederne un’altro con le stesse modalità.

{
  "Header": {
    "Authorization": "Bearer a8yRu.q8up0vYR6h35Yaq.0PGbT",
    ...
  }
}