Taotlege dokumenti
Kasutage lubatud MultiTEL API kontot. Parooliga konto puhul saatke HTTP Basic autentimisandmed, pääsmepõhise konto puhul aga Bearer pääse. Konto õigused ja IP-piirangud kehtivad endiselt. Ärge kasutage sisemise taustatöötlusprotsessi autentimisandmeid.
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_downloadKasutage sama kohustuslikku 32 märgist koosnevat kuueteistkümnendsüsteemis job_id väärtust nagu fax_status puhul. Kliendipäring on lubatud ainult autenditud omanikule. Selles näites salvestatakse vastuse päised ja baidid eraldi, et API viga ei peetaks ekslikult PDF dokumendiks.
Töödelge faili või JSON viga
Õnnestumise korral tagastatakse dokumendi töötlemata baidid koos manuse päistega Content-Type ja Content-Disposition, mitte JSON vastuseümbris. Kontrollige neid päiseid enne salvestatud failile nime andmist, selle avamist või töötlemist. Vastus võib olla PDF, TIFF või algses üleslaaditud vormingus, olenevalt sellest, milline dokument on saadaval. Järjekorras oleva töö puhul võidakse enne teisendamist tagastada selle algne lähtedokument.
Ebaõnnestumise korral tagastatakse tavaline JSON status/response vastuseümbris. API kood 400 tähendab, et job_id puudub või on vales vormingus; 401 tähendab, et autentimine puudub; 404 tähendab, et töö või selle fail ei ole sellele kontole kättesaadav. Kontrollige päist Content-Type ja välja status.code ka siis, kui HTTP olekukood on 200.
Kättesaadavus ja privaatsus
Töö kirje ei taga, et fail on igavesti allalaaditav; säilitustähtaega ei ole kontrollitud. Vajaduse korral salvestage dokumendid, millele teil on juurdepääsuõigus, enda hallatavasse salvestusruumi. Tagastatud fail võib sisaldada saaja privaatset teavet. Allalaadimine ei saada uut faksi.