Pyydä asiakirja
Käytä käytössä olevaa MultiTEL-palvelun API-tiliä. Lähetä salasanatilin tunnistetiedot käyttäen HTTP Basic -todennusta tai tunnistepohjaisen tilin Bearer-tunniste. Tilin käyttöoikeudet ja IP-rajoitukset ovat edelleen voimassa. Älä käytä sisäisten taustaprosessien tunnistetietoja.
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_downloadKäytä samaa pakollista 32 merkin heksadesimaalista job_id-arvoa kuin fax_status-kutsussa. Asiakaspyyntö on rajattu todennettuun omistajaan. Tämä esimerkki tallentaa vastauksen otsakkeet ja tavut erikseen, jotta API-virhettä ei erehdytä pitämään PDF-tiedostona.
Käsittele tiedosto tai JSON-virhe
Onnistunut pyyntö palauttaa asiakirjan raakatavut sekä liitetiedoston Content-Type- ja Content-Disposition-otsakkeet, ei JSON-vastausrakennetta. Tarkista nämä otsakkeet ennen tallennetun tiedoston nimeämistä, avaamista tai käsittelyä. Vastaus voi olla PDF-muodossa, TIFF-muodossa tai alkuperäisessä ladatussa muodossa sen mukaan, mikä asiakirja on saatavilla. Jonossa oleva työ voi palauttaa alkuperäisen lähdetiedostonsa ennen muunnosta.
Epäonnistunut pyyntö palauttaa tavallisen JSON-muotoisen status/response-vastausrakenteen. API-koodi 400 tarkoittaa, että job_id puuttuu tai on virheellisessä muodossa; 401 tarkoittaa, että todennus puuttuu; 404 tarkoittaa, että työ tai sen tiedosto ei ole tämän tilin saatavilla. Tarkista Content-Type ja status.code myös silloin, kun HTTP-tilakoodi on 200.
Saatavuus ja yksityisyys
Työtietue ei takaa, että tiedosto on ladattavissa ikuisesti; säilytysaikaa ei ole varmistettu. Tallenna tarvittaessa asiakirjat, joihin sinulla on käyttöoikeus, omaan hallinnassasi olevaan tallennustilaan. Palautettu tiedosto voi sisältää vastaanottajan yksityisiä tietoja. Lataaminen ei lähetä uutta faksia.