MultiTEL
Разработчици

GET/v3/fax_download?job_id={job_id}

Изтегляне на документа на изходящ факс

Изтеглете наличния документ за една от вашите задачи за изпращане на факс.

На тази страница
  1. Заявете документа
  2. Обработете файл или грешка във формат JSON
  3. Наличност и поверителност

Заявете документа

Използвайте активиран акаунт за 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.

Наличност и поверителност

Наличието на запис за задача не гарантира, че файлът ще може да се изтегля завинаги; срокът за съхранение не е потвърден. При необходимост запазвайте документите, за които имате разрешение, в собствено хранилище под ваш контрол. Върнатият файл може да съдържа поверителна информация за получателя. Изтеглянето не изпраща нов факс.