MultiTEL
Dezvoltatori

GET/v3/fax_download?job_id={job_id}

Descărcați documentul unui fax de ieșire

Obțineți documentul disponibil pentru una dintre operațiunile dvs. de trimitere a faxurilor.

Pe această pagină
  1. Solicitați documentul
  2. Gestionați un fișier sau o eroare JSON
  3. Disponibilitate și confidențialitate

Solicitați documentul

Utilizați un cont MultiTEL API activat. Trimiteți datele de autentificare HTTP Basic pentru un cont cu parolă sau un token Bearer pentru un cont cu token. Permisiunile contului și restricțiile IP se aplică în continuare. Nu utilizați datele de autentificare ale proceselor de lucru interne.

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

Utilizați același job_id hexazecimal obligatoriu de 32 de caractere ca pentru fax_status. Solicitarea clientului este permisă numai proprietarului autentificat. Acest exemplu salvează separat antetele și octeții răspunsului, astfel încât o eroare API să nu fie confundată cu un fișier PDF.

Gestionați un fișier sau o eroare JSON

În caz de succes, sunt returnați octeții neprelucrați ai documentului, cu antetele Content-Type și Content-Disposition pentru atașament, nu o structură de încadrare JSON. Verificați aceste antete înainte de a denumi, deschide sau prelucra fișierul salvat. Răspunsul poate fi în format PDF, TIFF sau în formatul original încărcat, în funcție de documentul disponibil. Pentru o operațiune aflată în coada de așteptare, poate fi returnat fișierul-sursă original înainte de conversie.

În caz de eșec, este returnată structura obișnuită JSON de încadrare status/response. Codul API 400 înseamnă că job_id lipsește sau are un format incorect; 401 înseamnă că lipsește autentificarea; 404 înseamnă că operațiunea sau fișierul acesteia nu este disponibil pentru acest cont. Verificați Content-Type și status.code chiar și atunci când codul de stare HTTP este 200.

Disponibilitate și confidențialitate

Existența unei înregistrări a operațiunii nu garantează că fișierul va putea fi descărcat la nesfârșit; nu a fost verificată o perioadă de păstrare. Când este necesar, salvați documentele pe care sunteți autorizat să le accesați într-un spațiu de stocare propriu, pe care îl controlați. Fișierul returnat poate conține informații confidențiale despre destinatar. Descărcările nu trimit un fax nou.