Kontrola stavu faxové úlohy

Vyhledejte svou faxovou úlohu

Použijte povolený účet MultiTEL API. Pro účet s heslem odešlete přihlašovací údaje HTTP Basic, nebo pro účet s tokenem token Bearer. Oprávnění účtu a omezení IP adres nadále platí. Nepoužívejte interní přihlašovací údaje pracovního procesu.

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

job_id je povinné a musí jít o 32znakový šestnáctkový identifikátor vrácený voláním send_fax. Zkopírujte jej přesně. Požadavky jsou omezeny na ověřeného vlastníka.

Přečtěte výsledek

Zkontrolujte výsledek HTTP i hodnotu v JSON: status.code. Chyby JSON mohou přijít s HTTP 200. Úspěšná odpověď JSON obsahuje status a response; příklady používají smyšlené údaje.

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

Příklad představuje úlohu ve frontě, nikoli doručený fax nebo cenovou nabídku. pages_requested je zjištěný počet stran zdrojového dokumentu; pages_sent uvádí průběh zaznamenaný při zpracování. cost je řetězec s desetinným číslem a už ve frontě může obsahovat odhad. result obsahuje podrobnosti zpracování; webhook_status obsahuje zaznamenaný stav zpětného volání. Časové údaje jsou řetězce formátované serverem bez posunu časového pásma.

Dotazujte se v postupně se prodlužujících intervalech, nikoli v těsné smyčce. Zpracování může hlásit stav odesláno nebo dokončeno, ale současný audit neprokázal záruku doručení příjemci. U důležitého dokumentu si u příjemce ověřte přijetí, než jej budete považovat za doručený nebo odešlete kopii. Životní cyklus aktivního pracovního procesu, konečná pravidla účtování a smlouva zpětných volání se stále ověřují. Nepředpokládejte, že přijetí do fronty nebo neprázdný identifikátor úlohy znamená doručení.

Chyby

Kód API 400 znamená chybějící nebo nesprávně utvořené job_id; 401 znamená chybějící ověření identity; 404 znamená, že úloha nebyla pro tento účet nalezena. Samotný identifikátor není důkazem vlastnictví.