Faxfeladat állapotának ellenőrzése

A faxfeladat lekérdezése

Használjon engedélyezett MultiTEL API-fiókot. Jelszavas fióknál HTTP Basic hitelesítő adatokat, tokenes fióknál pedig Bearer tokent küldjön. A fiók jogosultságai és az IP-korlátozások továbbra is érvényesek. Ne használja a belső feldolgozó hitelesítő adatait.

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

job_id megadása kötelező; értéke a send_fax által visszaadott, 32 karakteres hexadecimális azonosító legyen. Pontosan másolja át. A kérések a hitelesített tulajdonosra korlátozódnak.

Az eredmény értelmezése

Olvassa el mind a HTTP eredményét, mind a JSON törzs status.code értékét. A JSON-hibák HTTP 200 válasszal is érkezhetnek. A sikeres JSON-válasz tartalmazza a következőket: status és response; a példákban szereplő adatok kitaláltak.

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

A példa egy várólistán lévő feladat, nem kézbesített fax és nem árajánlat. pages_requested az észlelt forrásoldalak száma; pages_sent a feldolgozás során rögzített előrehaladást jelzi. cost decimális értéket tartalmazó karakterlánc, amely már a várólistán is tartalmazhat becslést. result a feldolgozás részleteit tartalmazza; webhook_status a rögzített visszahívási állapotot tartalmazza. Az időbélyegek a szerver által formázott karakterláncok, időzóna-eltolás nélkül.

Szoros ciklus helyett egyre hosszabb időközönként kérdezzen le. A feldolgozás jelezhet elküldött vagy befejezett állapotot, de a jelenlegi ellenőrzés nem állapított meg kézbesítési garanciát a címzett számára. Fontos dokumentumnál erősíttesse meg az átvételt a címzettel, mielőtt kézbesítettnek tekintené vagy ismét elküldené. Az aktív feldolgozó életciklusát, a végső számlázási szabályokat és a visszahívási szerződést még ellenőrizzük. Ne feltételezze, hogy a várólistára vétel vagy egy nem üres feladatazonosító kézbesítést jelent.

Hibák

Az API 400 kódja hiányzó vagy hibás job_id értéket jelent; a 401 hiányzó hitelesítést; a 404 azt, hogy a feladat nem található ehhez a fiókhoz. Önmagában az azonosítóból ne következtessen a tulajdonjogra.