Preuzimanje dokumenta odlaznog faksa

Zatražite dokument

Upotrijebite omogućen MultiTEL API račun. Za račun s lozinkom pošaljite vjerodajnice za HTTP Basic, a za račun s tokenom pošaljite Bearer token. Dopuštenja računa i ograničenja IP adresa i dalje vrijede. Nemojte upotrebljavati vjerodajnice internih pozadinskih procesa.

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

Upotrijebite isti obvezni heksadekadski job_id od 32 znaka kao za fax_status. Korisnički zahtjev ograničen je na autentificiranog vlasnika. Ovaj primjer zasebno sprema zaglavlja odgovora i bajtove kako se pogreška API sučelja ne bi zamijenila za PDF dokument.

Obradite datoteku ili pogrešku u JSON formatu

Uspješan zahtjev vraća neobrađene bajtove dokumenta sa zaglavljima Content-Type i Content-Disposition za vrstu sadržaja i privitak, a ne omotnicu u JSON formatu. Provjerite ta zaglavlja prije imenovanja, otvaranja ili obrade spremljene datoteke. Odgovor može biti u PDF formatu, TIFF formatu ili izvornom prenesenom formatu, ovisno o tome koji je dokument dostupan. Zadatak u redu čekanja može vratiti svoju izvornu datoteku prije pretvorbe.

Neuspješan zahtjev vraća uobičajenu omotnicu u JSON formatu s poljima status/response. Kod API sučelja 400 znači da job_id nedostaje ili nije ispravno oblikovan; 401 znači da nedostaje autentifikacija; 404 znači da zadatak ili njegova datoteka nisu dostupni tom računu. Provjerite Content-Type i status.code čak i kada je HTTP status 200.

Dostupnost i privatnost

Zapis o zadatku ne jamči da će datoteka zauvijek biti dostupna za preuzimanje; razdoblje čuvanja nije potvrđeno. Po potrebi spremite dokumente za koje imate ovlaštenje u vlastitu pohranu pod svojim nadzorom. Vraćena datoteka može sadržavati privatne podatke o primatelju. Preuzimanjem se ne šalje novi faks.