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

Використовуйте той самий обов’язковий 32-символьний шістнадцятковий job_id, що й для 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.

Доступність і конфіденційність

Наявність запису про завдання не гарантує, що файл можна буде завантажувати завжди; строк зберігання не підтверджено. За потреби зберігайте документи, до яких маєте право доступу, у власному контрольованому сховищі. Повернутий файл може містити приватну інформацію одержувача. Завантаження не призводить до надсилання нового факсу.