Kontroleer die status van 'n fakstaak

Soek jou taak op

Gebruik 'n geaktiveerde MultiTEL API-rekening. Stuur HTTP Basic-aanmeldbesonderhede vir 'n wagwoordrekening, of 'n Bearer-teken vir 'n tekenrekening. Rekeningtoestemmings en IP-beperkings geld steeds. Moenie interne aanmeldbesonderhede van die werkproses gebruik nie.

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

job_id is verpligtend en moet die heksadesimale identifiseerder van 32 karakters wees wat deur send_fax teruggestuur word. Kopieer dit presies. Versoeke is tot die geoutentiseerde eienaar beperk.

Lees die resultaat

Lees sowel die HTTP-resultaat as die JSON-veld status.code. JSON-mislukkings kan met HTTP 200 terugkom. 'n Suksesvolle JSON-antwoord bevat status en response; die voorbeelde gebruik fiktiewe data.

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

Die voorbeeld is 'n taak in die waglys, nie 'n afgelewerde faks of 'n pryskwotasie nie. pages_requested is die bespeurde aantal bronbladsye; pages_sent meld die vordering wat tydens verwerking aangeteken is. cost is 'n desimale string en kan reeds 'n raming bevat terwyl die taak in die waglys is. result bevat verwerkingsbesonderhede; webhook_status bevat die aangetekende terugroepstatus. Tydstempels is bedienergeformateerde stringe sonder 'n tydsone-afwyking.

Doen navrae met toenemende tussenposes eerder as in 'n vinnige herhalingslus. Verwerking kan 'n gestuurde of voltooide status meld, maar die huidige oudit het nie 'n waarborg van aflewering aan die ontvanger vasgestel nie. Bevestig vir 'n belangrike dokument ontvangs by die ontvanger voordat jy dit as afgelewer beskou of 'n duplikaat stuur. Die aktiewe werkproses se lewensiklus, finale faktureringsreëls en terugroepkontrak word steeds geverifieer. Moenie aanvaar dat aanvaarding in die waglys of 'n nie-leë taak-ID aflewering beteken nie.

Foute

API-kode 400 beteken dat job_id ontbreek of verkeerd geformateer is; 401 beteken dat verifikasie van identiteit ontbreek; 404 beteken dat die taak nie vir hierdie rekening gevind is nie. Moenie eienaarskap slegs uit die identifiseerder aflei nie.