Chi può usare questa funzionalità?
Disponibile con il piano Enterprise.
Accessibile ai proprietari e agli amministratori sull'app web.
Per utilizzare l'API di Fax.Plus, devi prima concedere all'API l'autorizzazione ad accedere al tuo account. Una volta completato il processo di autorizzazione, potrai accedere al tuo account.
Esistono due metodi diversi per l'autenticazione:
- Genera e utilizza i token di accesso personali.
- Utilizza il flusso OAuth 2.0.
Un token di accesso personale può essere utilizzato come metodo di autenticazione per accedere in modo sicuro all'API di Fax.Plus. Questo token funge da firma digitale, consentendoti di effettuare richieste autorizzate alla nostra API, permettendo azioni come l'invio di fax e il recupero dei dati relativi ai tuoi fax.
Segui questi passaggi per generare un nuovo token di accesso personale:
- Accedi al tuo account Fax.Plus e vai alla sezione Impostazioni nella tua dashboard.
- Trova la scheda Integrazioni.
- In Fax.Plus API, trova la voce Token di accesso personali e fai clic su Gestisci.
- Fai clic su Genera token e specifica il nome del token, la data di scadenza e gli ambiti (sia modifica che lettura come ambiti sul token).
- Assicurati di fare clic su Copia per copiare il tuo token di accesso personale ora, altrimenti non potrai più visualizzarlo.
Fase 1: Configura il flusso di autenticazione iniziale
- Accedi al tuo account Fax.Plus e vai alla sezione Impostazioni nella tua dashboard.
- Trova la scheda Integrazioni.
- In Fax.Plus API, fai clic su Attiva e raccogli i seguenti dati:
- Client ID (inizia con APIK-)
- Client secret
- Redirect URI (uno di essi)
- Per avviare il processo di autorizzazione dell'API ad accedere al tuo account, fai semplicemente clic sul link fornito in questo passaggio utilizzando un browser web. Questo link ti reindirizzerà a una richiesta in cui potrai concedere le autorizzazioni necessarie: https://accounts.fax.plus/login?response_type=code&client_id=[client ID]&redirect_uri=[redirect URI]&scope=all
-
Una volta concessa l'autorizzazione, verrai indirizzato all'URL specificato, accompagnato dal codice di autorizzazione come parametro dell'URL:
Fase 2: Invia una richiesta HTTP POST
Dopo aver autorizzato correttamente l'accesso, puoi procedere effettuando una richiesta HTTP POST al seguente URL: https://accounts.fax.plus/token?grant_type=authorization_code&client_id=[client ID]&code=[authorization code]&redirect_uri=[redirect URI].
Assicurati di includere le seguenti intestazioni nella tua richiesta:
-
- Content-Type: application/x-www-form-urlencoded
- Authorization: Basic [base64-encoded string of "client_id:client_secret"]
- Content-Type: application/x-www-form-urlencoded
Una volta completato, riceverai una risposta contenente un token di accesso, valido per 1 ora, oltre a un token di aggiornamento con validità indefinita.
Nota: se il tuo account Fax.Plus ha l'opzione Advanced Security Controls attivata, il token di aggiornamento rimane valido per 30 giorni in conformità alle normative sulla sicurezza. Ciò implica che dovrai ripetere il processo ogni 30 giorni per ottenere un nuovo token di aggiornamento.
Fase 3: Ottieni un nuovo token di accesso
Una volta scaduto il tuo token di accesso, puoi ottenerne uno nuovo utilizzando il tuo token di aggiornamento tramite una richiesta HTTP POST al seguente URL: https://accounts.fax.plus/token?grant_type=refresh_token&refresh_token=[refresh token].
Questo processo richiede l'inclusione delle seguenti intestazioni:
-
- Content-Type: application/x-www-form-urlencoded
- Authorization: Basic [base64-encoded string of "client_id:client_secret"]
Dopo aver ottenuto il token di accesso, tutte le successive chiamate API richiederanno le seguenti intestazioni:
-
- Authorization: Bearer [access token]
- x-fax-clientid: [client ID]