Fax.Plus API oferece uma solução poderosa para reunir de forma simples informações e ficheiros de fax recebidos dos membros da sua equipa, desde que estes ocupem uma posição hierárquica inferior na estrutura da equipa.
Nota: Certifique-se de que concluiu o processo de autenticação inicial e de que iniciou sessão com êxito na API. Para obter instruções adicionais, consulte o nosso guia aqui.
Antes de continuar, verifique se o membro da equipa pretendido ocupa uma posição subordinada à do utilizador da API na estrutura hierárquica da equipa. Como ilustrado nas capturas de ecrã abaixo, a conta do Test Admin consegue ligar-se à API sem problemas, obtendo assim acesso a informações essenciais e a ficheiros de fax pertencentes ao Test Member.
Para obter a lista de todos os membros da empresa, envie um pedido HTTP GET para o seguinte URL: https://restapi.fax.plus/v3/accounts/.
Certifique-se de que inclui os seguintes cabeçalhos no seu pedido:
-
Content-Type:
multipart/form-data -
Authorization:
Bearer [access token] -
x-fax-clientid:
[client ID]
Poderá aceder aos dados do membro, incluindo o UID (ID de utilizador), que será incluído nos dados obtidos.
Depois de obter o ID de utilizador do membro, aceder aos faxes recebidos por este torna-se um processo simples. Para isso, basta enviar um pedido HTTP GET para o seguinte URL:
https://restapi.fax.plus/v3/accounts/[member user ID]/faxes?category=inbox.
Certifique-se de que inclui os seguintes cabeçalhos no seu pedido:
-
Authorization:
Bearer [access token]
-
x-fax-clientid:
[client ID]
O ID do fax pode ser obtido a partir da resposta.
Nota: Pode ser útil configurar um webhook dedicado para o evento „fax_received“, que não só lhe fornecerá o ID do fax do evento, como também oferecerá informações adicionais. Aprofunde este tema consultando mais informações. Para mais informações, consulte o nosso guia aqui.
Para obter os ficheiros do fax, pode enviar um pedido HTTP GET para o seguinte URL:
https://restapi.fax.plus/v3/accounts/[member user ID]/files/[fax ID]?format=pdf.
Certifique-se de que inclui os seguintes cabeçalhos no seu pedido:
-
Authorization:
Bearer [access token] -
x-fax-clientid:
[client ID]