Проверьте состояние задания факса

Найдите своё задание факса

Используйте активированную учётную запись 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 означает, что задание не найдено для этой учётной записи. Не делайте вывод о принадлежности только по идентификатору.