Kontrollera status för ett faxjobb

Slå upp ditt faxjobb

Använd ett aktiverat MultiTEL API-konto. Skicka HTTP Basic-inloggningsuppgifter för ett lösenordskonto, eller en Bearer-token för ett tokenkonto. Kontobehörigheter och IP-begränsningar gäller fortfarande. Använd inte interna inloggningsuppgifter för arbetsprocessen.

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

job_id krävs och måste vara den 32 tecken långa hexadecimala identifieraren som returneras av send_fax. Kopiera den exakt. Begäranden är avgränsade till den autentiserade ägaren.

Läs resultatet

Läs både HTTP-resultatet och JSON-fältet status.code. JSON-fel kan komma med HTTP 200. Ett lyckat JSON-svar innehåller status och response; exemplen använder fiktiva 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"
  }
}

Exemplet är ett köat jobb, inte ett levererat fax eller en prisoffert. pages_requested är det identifierade antalet sidor i källan; pages_sent visar de framsteg som registrerats under behandlingen. cost är en sträng med ett decimaltal och kan redan innehålla en uppskattning medan jobbet står i kö. result innehåller behandlingsdetaljer; webhook_status innehåller den registrerade återanropsstatusen. Tidsstämplarna är serverformaterade strängar utan tidszonsförskjutning.

Fråga med allt längre intervall i stället för i en tät loop. Behandlingen kan rapportera skickad eller slutförd status, men den aktuella granskningen har inte fastställt någon garanti för leverans till mottagaren. För ett viktigt dokument ska du bekräfta mottagandet med mottagaren innan du betraktar det som levererat eller skickar en kopia. Den aktiva arbetsprocessens livscykel, de slutliga faktureringsreglerna och återanropskontraktet håller fortfarande på att verifieras. Anta inte att godkännande till kön eller ett jobb-ID som inte är tomt innebär leverans.

Fel

API-kod 400 betyder att job_id saknas eller är felaktigt formaterat; 401 betyder att autentisering saknas; 404 betyder att jobbet inte hittades för det här kontot. Dra inte slutsatser om ägarskap enbart utifrån identifieraren.