A dokumentum lekérése
Használjon engedélyezett MultiTEL API-fiókot. Jelszavas fiók esetén küldjön HTTP Basic hitelesítési adatokat, tokenes fiók esetén pedig Bearer tokent. A fiók jogosultságai és az IP-korlátozások továbbra is érvényesek. Ne használja a belső háttérfeldolgozó hitelesítési adatait.
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_downloadUgyanazt a kötelező, 32 karakteres hexadecimális job_id értéket használja, mint a fax_status esetében. Az ügyféloldali kérést kizárólag a hitelesített tulajdonos adhatja ki. Ez a példa külön menti a válasz fejléceit és bájtjait, hogy egy API-hibát ne lehessen PDF-dokumentumnak nézni.
Fájl vagy JSON-hiba kezelése
Siker esetén a válasz a dokumentum nyers bájtjait tartalmazza Content-Type és a mellékletet jelző Content-Disposition fejlécekkel, nem pedig JSON-válaszburkolatot. Ellenőrizze ezeket a fejléceket, mielőtt elnevezi, megnyitja vagy feldolgozza a mentett fájlt. A válasz PDF, TIFF vagy az eredetileg feltöltött formátumú fájl lehet, attól függően, hogy melyik dokumentum érhető el. Egy várólistán lévő feladat esetén az átalakítás előtt még az eredeti forrásfájl is visszaadható.
Hiba esetén a szokásos JSON status/response válaszburkolat érkezik. A 400 értékű API-kód hiányzó vagy hibás formátumú job_id értéket jelent; a 401 hiányzó hitelesítést; a 404 pedig azt, hogy a feladat vagy a hozzá tartozó fájl nem érhető el ezzel a fiókkal. Ellenőrizze a Content-Type fejlécet és a status.code értékét akkor is, ha a HTTP-állapot 200.
Elérhetőség és adatvédelem
A feladat rekordjának megléte nem garantálja, hogy a fájl örökké letölthető marad; a megőrzési időt nem ellenőriztük. Szükség esetén mentse a saját felügyelete alatt álló tárhelyre azokat a dokumentumokat, amelyekhez jogosult hozzáférni. A visszaadott fájl a címzettre vonatkozó bizalmas adatokat tartalmazhat. A letöltés nem küld új faxot.