Kontrollige faksitöö olekut

Otsige oma faksitööd

Kasutage lubatud MultiTEL API kontot. Parooliga konto puhul saatke HTTP Basic autentimisandmed, pääsutõendiga konto puhul aga Bearer pääsutõend. Konto õigused ja IP-piirangud kehtivad endiselt. Ärge kasutage tööprotsessi sisemisi autentimisandmeid.

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

job_id on kohustuslik ja peab olema send_fax tagastatud 32 märgist koosnev kuueteistkümnendsüsteemis identifikaator. Kopeerige see täpselt. Päringud on piiratud autenditud omanikuga.

Lugege tulemust

Lugege nii HTTP tulemust kui ka JSON välja status.code. JSON vead võivad saabuda koos HTTP 200 vastusega. Edukas JSON vastus sisaldab välju status ja response; näited kasutavad väljamõeldud andmeid.

{
  "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"
  }
}

Näites on järjekorras töö, mitte kohale toimetatud faks ega hinnapakkumine. pages_requested on tuvastatud lähtelehekülgede arv; pages_sent näitab töötlemisel salvestatud edenemist. cost on kümnendarvuga string ja võib sisaldada hinnangut juba siis, kui töö on järjekorras. result sisaldab töötlemise üksikasju; webhook_status sisaldab salvestatud tagasikutse olekut. Ajatemplid on serveris vormindatud stringid ilma ajavööndi nihketa.

Tehke päringuid järjest pikemate vahedega, mitte tihedas tsüklis. Töötlemine võib teatada saadetud või lõpetatud olekust, kuid praegune audit ei ole tuvastanud adressaadile kohaletoimetamise garantiid. Kriitilise dokumendi puhul kinnitage selle kättesaamine adressaadiga enne, kui peate seda kohale toimetatuks või saadate koopia. Aktiivse tööprotsessi elutsüklit, lõplikke arveldusreegleid ja tagasikutse lepingut kontrollitakse endiselt. Ärge eeldage, et järjekorda vastuvõtmine või mittetühi töö ID tähendab kohaletoimetamist.

Vead

API kood 400 tähendab puuduvat või vigast job_id väärtust; 401 tähendab puuduvat autentimist; 404 tähendab, et selle konto jaoks tööd ei leitud. Ärge järeldage omandiõigust üksnes identifikaatorist.