Programeri

GET/v3/fax_status?job_id={job_id}

Provjerite status zadatka faksa

Pročitajte jedan izlazni zadatak faksa koji pripada vašem računu pomoću ID-a zadatka koji vraća send_fax.

Na ovoj stranici
  1. Pronađite svoj zadatak
  2. Pročitajte rezultat
  3. Pogreške

Pronađite svoj zadatak

Upotrijebite omogućeni MultiTEL API račun. Za račun s lozinkom pošaljite vjerodajnice HTTP Basic, a za račun s tokenom token Bearer. Dozvole računa i IP ograničenja i dalje vrijede. Nemojte upotrebljavati interne vjerodajnice radnog procesa.

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 obvezan i mora biti heksadekadski identifikator od 32 znaka koji vraća send_fax. Kopirajte ga točno. Zahtjevi su ograničeni na autentificiranog vlasnika.

Pročitajte rezultat

Pročitajte i HTTP rezultat i polje status.code u JSON. Pogreške JSON mogu stići uz HTTP 200. Uspješan odgovor JSON sadrži status i response; primjeri upotrebljavaju izmišljene podatke.

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

Primjer prikazuje zadatak na čekanju, a ne dostavljeni faks ili ponudu cijene. pages_requested je otkriveni broj stranica izvornog dokumenta; pages_sent prikazuje napredak zabilježen tijekom obrade. cost je niz znakova s decimalnim brojem i već može sadržavati procjenu dok zadatak čeka u redu. result sadrži pojedinosti obrade; webhook_status sadrži zabilježeno stanje povratnog poziva. Vremenske oznake su nizovi znakova koje oblikuje poslužitelj, bez pomaka vremenske zone.

Provjeravajte u sve duljim razmacima, a ne u uskoj petlji. Obrada može prijaviti stanje poslano ili dovršeno, ali trenutačna provjera nije utvrdila jamstvo dostave primatelju. Za važan dokument potvrdite primitak s primateljem prije nego što ga smatrate dostavljenim ili pošaljete duplikat. Životni ciklus aktivnog radnog procesa, konačna pravila naplate i ugovor povratnih poziva još se provjeravaju. Nemojte pretpostaviti da prihvaćanje u red ili neprazan ID zadatka znači dostavu.

Pogreške

API kod 400 znači da job_id nedostaje ili je pogrešno oblikovan; 401 znači da nedostaje autentifikacija; 404 znači da zadatak nije pronađen za ovaj račun. Nemojte zaključivati o vlasništvu samo na temelju identifikatora.