Преузимање документа одлазног факса

Затражите документ

Користите активиран налог за MultiTEL API. За налог са лозинком пошаљите акредитиве за HTTP Basic аутентификацију, а за налог са токеном пошаљите Bearer токен. Дозволе налога и ограничења IP адреса и даље важе. Не користите интерне акредитиве позадинских радних процеса.

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

Користите исти обавезни хексадецимални job_id од 32 знака као за fax_status. Кориснички захтев је ограничен на аутентификованог власника. Овај пример одвојено чува заглавља и бајтове одговора како се грешка API не би погрешно сматрала документом у формату PDF.

Обрадите датотеку или грешку у формату JSON

При успешном захтеву враћају се сирови бајтови документа са заглављима Content-Type и Content-Disposition за прилог, а не омотач у формату JSON. Проверите та заглавља пре него што сачуваној датотеци дате име, отворите је или обрадите. Одговор може бити у формату PDF, TIFF или у изворном формату отпремљене датотеке, у зависности од тога који је документ доступан. За задатак у реду за обраду може бити враћена изворна датотека пре конверзије.

При неуспеху враћа се уобичајени омотач у формату JSON са структуром status/response. Код API 400 значи да job_id недостаје или је неисправног формата; 401 значи да недостаје аутентификација; 404 значи да задатак или његова датотека нису доступни овом налогу. Проверите Content-Type и status.code чак и када је HTTP статус 200.

Доступност и приватност

Постојање записа о задатку не гарантује да ће датотека заувек бити доступна за преузимање; период чувања није потврђен. По потреби сачувајте документе за које имате овлашћење у сопственом складишту под својом контролом. Враћена датотека може садржати приватне податке о примаоцу. Преузимањем се не шаље нови факс.