Перевірте стан завдання факсу

Знайдіть своє завдання факсу

Використовуйте активований обліковий запис MultiTEL API. Для облікового запису з паролем надсилайте облікові дані HTTP Basic, а для облікового запису з токеном — токен Bearer. Права облікового запису й обмеження IP залишаються чинними. Не використовуйте внутрішні облікові дані обробника.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id є обов’язковим і має бути 32-символьним шістнадцятковим ідентифікатором, повернутим send_fax. Скопіюйте його точно. Запити обмежено автентифікованим власником.

Прочитайте результат

Перевіряйте і результат HTTP, і поле в JSON: status.code. Помилки JSON можуть надходити з HTTP 200. Успішна відповідь JSON містить status і response; у прикладах використано вигадані дані.

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

У прикладі наведено завдання в черзі, а не доставлений факс чи цінову пропозицію. pages_requested — це виявлена кількість сторінок джерела; pages_sent повідомляє про перебіг, зафіксований під час обробки. cost — це рядок із десятковим числом, який може містити оцінку вже під час перебування в черзі. result містить подробиці обробки; webhook_status містить зафіксований стан зворотного виклику. Позначки часу — це рядки у форматі сервера без зсуву часового поясу.

Опитуйте зі щораз більшими інтервалами, а не в щільному циклі. Обробка може повідомляти стан «надіслано» або «завершено», але поточний аудит не встановив гарантії доставки одержувачу. Для важливого документа підтвердьте отримання з одержувачем, перш ніж вважати документ доставленим або надсилати дублікат. Життєвий цикл активного обробника, остаточні правила виставлення рахунків і контракт зворотних викликів ще перевіряються. Не припускайте, що прийняття в чергу чи непорожній ідентифікатор завдання означають доставку.

Помилки

Код API 400 означає відсутній або неправильно сформований job_id; 401 означає відсутність автентифікації; 404 означає, що завдання не знайдено для цього облікового запису. Не робіть висновків про належність лише за ідентифікатором.