Pieprasiet dokumentu
Izmantojiet iespējotu MultiTEL API kontu. Kontam ar paroli nosūtiet HTTP Basic akreditācijas datus, bet kontam ar piekļuves pilnvaru — Bearer piekļuves pilnvaru. Joprojām ir spēkā konta atļaujas un IP adrešu ierobežojumi. Neizmantojiet iekšējā fona apstrādes procesa akreditācijas datus.
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_downloadIzmantojiet to pašu obligāto 32 rakstzīmju heksadecimālo job_id vērtību, ko izmanto fax_status. Klienta pieprasījums ir atļauts tikai autentificētajam īpašniekam. Šajā piemērā atbildes galvenes un baiti tiek saglabāti atsevišķi, lai API kļūdu nesajauktu ar PDF dokumentu.
Apstrādājiet failu vai JSON kļūdu
Veiksmīga pieprasījuma gadījumā tiek atgriezti dokumenta neapstrādātie baiti ar pielikuma galvenēm Content-Type un Content-Disposition, nevis JSON atbildes aploksne. Pirms saglabātajam failam piešķirat nosaukumu, to atverat vai apstrādājat, pārbaudiet šīs galvenes. Atbilde var būt PDF, TIFF vai sākotnējā augšupielādes formātā atkarībā no tā, kurš dokuments ir pieejams. Rindā esošam uzdevumam pirms pārveidošanas var tikt atgriezts tā sākotnējais avota dokuments.
Neveiksmes gadījumā tiek atgriezta parastā JSON status/response atbildes aploksne. API kods 400 nozīmē, ka job_id nav norādīts vai tā formāts ir nepareizs; 401 nozīmē, ka nav autentifikācijas; 404 nozīmē, ka uzdevums vai tā fails šim kontam nav pieejams. Pārbaudiet Content-Type un status.code arī tad, ja HTTP statuss ir 200.
Pieejamība un privātums
Uzdevuma ieraksts negarantē, ka fails būs lejupielādējams vienmēr; glabāšanas termiņš nav pārbaudīts. Ja nepieciešams, saglabājiet dokumentus, kuriem jums ir piekļuves tiesības, savā kontrolētā krātuvē. Atgrieztajā failā var būt privāta informācija par saņēmēju. Lejupielāde nenosūta jaunu faksu.