Izstrādātājiem

GET/v3/fax_status?job_id={job_id}

Pārbaudiet faksa uzdevuma statusu

Nolasiet vienu jūsu kontam piederošu izejošā faksa uzdevumu, izmantojot send_fax atgriezto uzdevuma ID.

Šajā lapā
  1. Atrodiet savu faksa uzdevumu
  2. Lasiet rezultātu
  3. Kļūdas

Atrodiet savu faksa uzdevumu

Izmantojiet iespējotu MultiTEL API kontu. Paroles kontam nosūtiet HTTP Basic akreditācijas datus, bet kontam ar marķieri — Bearer marķieri. Konta atļaujas un IP ierobežojumi joprojām ir spēkā. Neizmantojiet iekšējos darba procesa akreditācijas datus.

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

job_id ir obligāts, un tam jābūt send_fax atgrieztajam 32 rakstzīmju heksadecimālajam identifikatoram. Nokopējiet to precīzi. Pieprasījumi ir ierobežoti ar autentificēto īpašnieku.

Lasiet rezultātu

Lasiet gan HTTP rezultātu, gan JSON lauku status.code. JSON kļūmes var tikt atgrieztas ar HTTP 200. Veiksmīgā JSON atbildē ir status un response; piemēros izmantoti izdomāti dati.

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

Piemērā ir rindā ievietots uzdevums, nevis piegādāts fakss vai cenas piedāvājums. pages_requested ir noteiktais avota lappušu skaits; pages_sent norāda apstrādes laikā reģistrēto norisi. cost ir decimālskaitļa virkne, kurā jau var būt aplēse, kamēr uzdevums ir rindā. result satur apstrādes informāciju; webhook_status satur reģistrēto atzvana stāvokli. Laikspiedoli ir servera formatētas virknes bez laika joslas nobīdes.

Veiciet atkārtotus vaicājumus arvien garākos intervālos, nevis ciešā ciklā. Apstrāde var ziņot par nosūtītu vai pabeigtu stāvokli, taču pašreizējā pārbaudē nav konstatēta piegādes garantija saņēmējam. Svarīgam dokumentam apstipriniet saņemšanu pie saņēmēja, pirms uzskatāt to par piegādātu vai sūtāt vēlreiz. Aktīvā darba procesa dzīves cikls, galīgie norēķinu noteikumi un atzvana līgums vēl tiek pārbaudīti. Nepieņemiet, ka pieņemšana rindā vai netukšs uzdevuma ID nozīmē piegādi.

Kļūdas

API kods 400 nozīmē trūkstošu vai nepareizi veidotu job_id; 401 nozīmē trūkstošu autentifikāciju; 404 nozīmē, ka uzdevums šim kontam nav atrasts. Neizdariet secinājumus par īpašumtiesībām tikai pēc identifikatora.