Scaricare il documento di un fax in uscita

Richiedere il documento

Usa un account API MultiTEL abilitato. Invia le credenziali HTTP Basic per un account con password oppure un token Bearer per un account con token. Le autorizzazioni dell'account e le restrizioni sugli indirizzi IP continuano ad applicarsi. Non usare le credenziali dei processi di elaborazione interni.

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_download

Usa lo stesso job_id obbligatorio in formato esadecimale di 32 caratteri usato per fax_status. La richiesta del cliente è riservata al proprietario autenticato. Questo esempio salva separatamente le intestazioni e i byte della risposta, in modo che un errore API non venga scambiato per un PDF.

Gestire un file o un errore JSON

In caso di successo, vengono restituiti i byte grezzi del documento con le intestazioni Content-Type e Content-Disposition per l'allegato, non una struttura di risposta JSON. Controlla queste intestazioni prima di assegnare un nome al file salvato, aprirlo o elaborarlo. La risposta può essere in formato PDF, TIFF o nel formato originale del file caricato, a seconda del documento disponibile. Un processo in coda può restituire il file sorgente originale prima della conversione.

In caso di errore, viene restituita la normale struttura di risposta JSON status/response. Il codice API 400 indica che job_id è assente o non è nel formato corretto; 401 indica che manca l'autenticazione; 404 indica che il processo o il relativo file non è disponibile per questo account. Controlla Content-Type e status.code anche quando il codice di stato HTTP è 200.

Disponibilità e riservatezza

La presenza di un record del processo non garantisce che il file rimanga scaricabile per sempre; non è stato verificato alcun periodo di conservazione. Quando necessario, salva i documenti per i quali disponi dell'autorizzazione in uno spazio di archiviazione sotto il tuo controllo. Il file restituito può contenere informazioni riservate sul destinatario. Scaricare un documento non comporta l'invio di un nuovo fax.