Kontrolloni statusin e detyrës së faksit

Kërkoni detyrën tuaj

Përdorni një llogari MultiTEL API të aktivizuar. Dërgoni kredencialet HTTP Basic për një llogari me fjalëkalim, ose një token Bearer për një llogari me token. Lejet e llogarisë dhe kufizimet IP zbatohen ende. Mos përdorni kredenciale të brendshme të punëtorit.

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

job_id është i kërkuar dhe duhet të jetë identifikuesi heksadecimal me 32 karaktere i kthyer nga send_fax. Kopjojeni saktësisht. Kërkesat janë të kufizuara te pronari i autentikuar.

Lexoni rezultatin

Lexoni si rezultatin HTTP, ashtu edhe JSON status.code. Dështimet JSON mund të mbërrijnë me HTTP 200. Një përgjigje e suksesshme JSON ka status dhe response; shembujt përdorin të dhëna fiktive.

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

Shembulli është një detyrë në radhë, jo një faks i dorëzuar ose një ofertë çmimi. pages_requested është numri i zbuluar i faqeve burimore; pages_sent raporton përparimin e regjistruar nga përpunimi. cost është një varg dhjetor dhe mund të përmbajë tashmë një vlerësim ndërsa është në radhë. result mbart detajin e përpunimit; webhook_status mbart gjendjen e regjistruar të kthimit të thirrjes. Vulat kohore janë vargje të formatuara nga serveri pa shmangie të zonës kohore.

Pyetni me intervale në rritje dhe jo me një cikël të ngushtë. Përpunimi mund të raportojë një gjendje të dërguar ose të përfunduar, por auditimi aktual nuk ka vendosur një garanci dorëzimi te marrësi. Për një dokument kritik, konfirmoni marrjen me marrësin përpara se ta trajtoni si të dorëzuar ose të dërgoni një kopje të dyfishtë. Cikli aktiv i jetës së punëtorit, rregullat përfundimtare të faturimit dhe kontrata e kthimit të thirrjes janë ende duke u verifikuar. Mos supozoni se pranimi në radhë ose një ID detyre jo-boshe do të thotë dorëzim.

Gabimet

Kodi API 400 do të thotë job_id që mungon ose i keqformuar; 401 do të thotë autentikim që mungon; 404 do të thotë se detyra nuk u gjet për këtë llogari. Mos nxirrni pronësinë vetëm nga identifikuesi.