Oauth V2

La chiave di accesso in sicurezza a tutte le API.

Oauth è il service di autenticazione per l'utilizzo delle API e garantisce la gestione sicura delle richieste e integrazioni.

Puoi generare un token in due modalità:

  • effettuando una richiesta all’endpoint POST /token
  • utilizzando il tool disponibile nella sezione Autenticazione della console

OAuth 2 consente di configurare token con restrizioni avanzate, non solo temporali ma anche operative.

In particolare, puoi definire:

  • numero massimo totale di richieste
  • numero di richieste su wallet
  • numero di richieste su abbonamento
  • limite massimo di spesa su wallet
  • restrizioni per indirizzo IP

Il token sandbox è utilizzato per effettuare chiamate in ambiente di test e può essere generato solo dopo l’attivazione dell’account sandbox. Il token di produzione, invece, è necessario per eseguire richieste in ambiente live. Può essere creato esclusivamente per API o scope già attivati.

Puoi consultare l’elenco dei token attraverso:

  • l’endpoint GET /token, che restituisce tutti i token non scaduti
  • l’endpoint GET /token/{token}, per ottenere i dettagli di un token specifico (es. scadenza e scope associati)

In alternativa, la lista completa dei token (sandbox e produzione) è disponibile anche nella sezione Autenticazione della console.

Sì, puoi eliminare un token in due modi:

  • dalla sezione Autenticazione, cliccando sull’icona del cestino
  • tramite l’endpoint dedicato DELETE /token/{token}

Puoi controllare il credito disponibile in due modi:

  • effettuando una richiesta all’endpoint GET /wallet
  • accedendo alla console, dove l’importo aggiornato è sempre visibile nella parte superiore dell’interfaccia

L’API OAuth v2 consente di accedere a un insieme completo di statistiche utili per monitorare utilizzo, performance e consumo del tuo account.

In particolare, puoi ottenere:

  1. Statistiche complessive dell’account
    Panoramica generale con informazioni su:
    - numero totale di richieste effettuate
    - richieste tramite wallet
    - richieste tramite abbonamento
    - numero di errori
    - saldo del wallet
    - numero di IP utilizzati
    - numero totale di API attive/utilizzate
  2. Elenco degli IP autorizzati
    Lista completa degli IP (IPS) associati alle chiamate API.
  3. Statistiche aggregate per singola API
    Analisi dei consumi e delle performance suddivisa per ciascuna API utilizzata.
  4. Statistiche dettagliate per singola API e endpoint
    Approfondimento a livello di endpoint, con metriche specifiche per ogni chiamata.