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

Потърсете вашата задача

Използвайте активиран MultiTEL API акаунт. Изпратете HTTP Basic идентификационни данни за акаунт с парола, или Bearer токен за акаунт с токен. Разрешенията на акаунта и IP ограниченията продължават да важат. Не използвайте вътрешни идентификационни данни на worker.

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 носи записаното състояние на обратното извикване. Времевите маркери са низове, форматирани от сървъра, без отместване на часовата зона.

Проверявайте с нарастващи интервали, а не в стегнат цикъл. Обработката може да отчете състояние изпратено или завършено, но текущият одит не е установил гаранция за доставка до получателя. За критичен документ потвърдете получаването с получателя, преди да го третирате като доставен или да изпратите дубликат. Жизненият цикъл на активния worker, окончателните правила за таксуване и договорът за обратно извикване все още се верифицират. Не предполагайте, че приемането в опашката или непразен идентификатор на задача означава доставка.

Грешки

API код 400 означава липсващ или неправилно формиран job_id; 401 означава липсващо удостоверяване; 404 означава, че задачата не е намерена за този акаунт. Не заключавайте собственост само въз основа на идентификатора.