Ladda ner ett dokument för ett utgående fax

Begär dokumentet

Använd ett aktiverat MultiTEL-konto för API. Skicka inloggningsuppgifter med HTTP Basic för ett lösenordskonto, eller en Bearer-token för ett tokenkonto. Kontots behörigheter och IP-begränsningar gäller fortfarande. Använd inte inloggningsuppgifter för interna bakgrundsprocesser.

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

Använd samma obligatoriska hexadecimala job_id med 32 tecken som för fax_status. Kundens begäran är begränsad till den autentiserade ägaren. Det här exemplet sparar svarshuvuden och byte separat så att ett API-fel inte misstas för en PDF-fil.

Hantera en fil eller ett JSON-fel

Vid framgång returneras dokumentets råa byte med huvudena Content-Type och Content-Disposition för en bifogad fil, inte en JSON-svarsstruktur. Kontrollera dessa huvuden innan du namnger, öppnar eller bearbetar den sparade filen. Svaret kan vara i PDF-format, TIFF-format eller det ursprungliga uppladdade formatet, beroende på vilket dokument som finns tillgängligt. Ett köat jobb kan returnera sin ursprungliga källfil före konverteringen.

Vid fel returneras den vanliga JSON-svarsstrukturen med status/response. API-koden 400 betyder att job_id saknas eller har fel format; 401 betyder att autentisering saknas; 404 betyder att jobbet eller dess fil inte är tillgängligt för det här kontot. Kontrollera Content-Type och status.code även när HTTP-statusen är 200.

Tillgänglighet och integritet

Att en jobbpost finns garanterar inte att en fil kan laddas ner för alltid; någon lagringstid har inte verifierats. Spara vid behov dokument som du har behörighet till i egen lagring som du kontrollerar. Den returnerade filen kan innehålla privata uppgifter om mottagaren. Nedladdningar skickar inte något nytt fax.