L'API di Fax.Plus offre una soluzione potente per raccogliere senza problemi informazioni e file fax ricevuti dai membri del tuo team, a condizione che occupino una posizione inferiore nella struttura gerarchica del team.
Nota: assicurati di aver completato il processo di autenticazione iniziale e di aver effettuato correttamente l'accesso all'API. Per ulteriori istruzioni, consulta la nostra guida qui.
Prima di procedere, verifica che il membro del team interessato abbia una posizione subordinata rispetto all'utente API nella struttura gerarchica del team. Come illustrato negli screenshot qui sotto, l'account Test Admin può collegarsi senza problemi all'API, ottenendo così l'accesso a informazioni essenziali e ai file fax appartenenti a Test Member.
Per ottenere l'elenco di tutti i membri aziendali, invia una richiesta HTTP GET al seguente URL: https://restapi.fax.plus/v3/accounts/.
Assicurati di includere nella richiesta le seguenti intestazioni:
-
Content-Type:
multipart/form-data -
Authorization:
Bearer [access token] -
x-fax-clientid:
[client ID]
Potrai accedere ai dettagli del membro, incluso l'UID (User ID), che sarà presente nei dati recuperati.
Dopo aver ottenuto l'ID utente del membro, accedere ai suoi fax ricevuti diventa un processo semplice. Per farlo, basta inviare una richiesta HTTP GET al seguente URL:
https://restapi.fax.plus/v3/accounts/[member user ID]/faxes?category=inbox.
Assicurati di includere nella richiesta le seguenti intestazioni:
-
Authorization:
Bearer [access token]
-
x-fax-clientid:
[client ID]
L'ID del fax può essere recuperato dalla risposta.
Nota: potresti valutare la configurazione di un webhook dedicato per l'evento "fax_received", che non solo ti fornirà l'ID del fax dell'evento, ma offrirà anche ulteriori informazioni. Approfondisci consultando ulteriori informazioni. Per maggiori dettagli, consulta la nostra guida qui.
Per recuperare i file del fax, puoi inviare una richiesta HTTP GET al seguente URL:
https://restapi.fax.plus/v3/accounts/[member user ID]/files/[fax ID]?format=pdf.
Assicurati di includere nella richiesta le seguenti intestazioni:
-
Authorization:
Bearer [access token] -
x-fax-clientid:
[client ID]