Solicitar o documento
Use uma conta habilitada da API da MultiTEL. Envie credenciais HTTP Basic para uma conta com senha, ou um token Bearer para uma conta com token. As permissões da conta e as restrições de IP continuam a se aplicar. Não use credenciais dos executores internos.
curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
--data-urlencode job_id=0123456789abcdef0123456789abcdef \
--dump-header fax-response.headers --output fax-response.bin \
https://api.multitel.net/v3/fax_downloadUse o mesmo job_id hexadecimal obrigatório de 32 caracteres usado em fax_status. A solicitação do cliente é restrita ao proprietário autenticado. Este exemplo salva os cabeçalhos e os bytes da resposta separadamente para que um erro da API não seja confundido com um PDF.
Tratar um arquivo ou um erro em JSON
Em caso de sucesso, são retornados os bytes brutos do documento com os cabeçalhos Content-Type e Content-Disposition de arquivo anexo, e não uma estrutura envolvente JSON. Verifique esses cabeçalhos antes de dar um nome ao arquivo salvo, abri-lo ou processá-lo. A resposta pode ser um PDF, um TIFF ou o formato original do arquivo enviado, dependendo de qual documento estiver disponível. Um trabalho na fila pode retornar seu arquivo de origem antes da conversão.
Em caso de falha, é retornada a estrutura envolvente JSON habitual de status/response. O código 400 da API indica que job_id está ausente ou com formato incorreto; 401 indica ausência de autenticação; 404 indica que o trabalho ou seu arquivo está indisponível para esta conta. Verifique Content-Type e status.code mesmo quando o status HTTP for 200.
Disponibilidade e privacidade
A existência de um registro do trabalho não garante que o arquivo possa ser baixado para sempre; nenhum prazo de retenção foi verificado. Quando necessário, salve os documentos que você tem autorização para guardar em um armazenamento próprio sob seu controle. O arquivo retornado pode conter informações privadas do destinatário. Os downloads não transmitem um novo fax.