MultiTEL
Zhvilluesit

GET/v3/fax_download?job_id={job_id}

Shkarkoni dokumentin e një faksi dalës

Merrni dokumentin e disponueshëm për një nga detyrat tuaja të dërgimit të faksit.

Në këtë faqe
  1. Kërkoni dokumentin
  2. Trajtoni një skedar ose një gabim JSON
  3. Disponueshmëria dhe privatësia

Kërkoni dokumentin

Përdorni një llogari të aktivizuar të API të MultiTEL. Dërgoni kredencialet e autentikimit HTTP Basic për një llogari me fjalëkalim, ose një token Bearer për një llogari me token. Lejet e llogarisë dhe kufizimet e IP-së vazhdojnë të zbatohen. Mos përdorni kredencialet e proceseve të brendshme të punës.

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

Përdorni të njëjtin job_id heksadecimal të detyrueshëm me 32 karaktere si për fax_status. Kërkesa e klientit lejohet vetëm për pronarin e autentikuar. Ky shembull i ruan veçmas fushat e kreut dhe bajtet e përgjigjes, në mënyrë që një gabim i API të mos ngatërrohet me një skedar PDF.

Trajtoni një skedar ose një gabim JSON

Në rast suksesi, kthehen bajtet e papërpunuara të dokumentit me fushat e kreut Content-Type dhe Content-Disposition për bashkëngjitjen, jo një strukturë mbështjellëse JSON. Kontrolloni këto fusha përpara se t'i caktoni emër skedarit të ruajtur, ta hapni ose ta përpunoni. Përgjigjja mund të jetë në formatin PDF, TIFF ose në formatin origjinal të ngarkuar, në varësi të dokumentit që është i disponueshëm. Një detyrë në radhë mund të kthejë skedarin e vet burimor origjinal përpara konvertimit.

Në rast dështimi, kthehet struktura e zakonshme mbështjellëse JSON status/response. Kodi i API 400 do të thotë se job_id mungon ose ka format të pasaktë; 401 do të thotë se mungon autentikimi; 404 do të thotë se detyra ose skedari i saj nuk është i disponueshëm për këtë llogari. Kontrolloni Content-Type dhe status.code edhe kur kodi i statusit HTTP është 200.

Disponueshmëria dhe privatësia

Ekzistenca e një regjistrimi të detyrës nuk garanton që skedari do të mund të shkarkohet përgjithmonë; nuk është verifikuar një periudhë ruajtjeje. Kur është e nevojshme, ruani dokumentet që jeni të autorizuar të përdorni në hapësirën tuaj të ruajtjes që e kontrolloni vetë. Skedari i kthyer mund të përmbajë informacione private për marrësin. Shkarkimet nuk dërgojnë një faks të ri.