Kontroller statusen til en faksjobb

Slå opp faksjobben din

Bruk en aktivert MultiTEL API-konto. Send HTTP Basic-påloggingsinformasjon for en passordkonto, eller et Bearer-token for en tokenkonto. Kontotillatelser og IP-begrensninger gjelder fortsatt. Ikke bruk intern påloggingsinformasjon for arbeidsprosessen.

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

job_id er påkrevd og må være den 32 tegn lange heksadesimale identifikatoren som returneres av send_fax. Kopier den nøyaktig. Forespørsler er avgrenset til den autentiserte eieren.

Les resultatet

Les både HTTP-resultatet og JSON-feltet status.code. JSON-feil kan komme med HTTP 200. Et vellykket JSON-svar inneholder status og response; eksemplene bruker fiktive 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"
  }
}

Eksemplet er en jobb i kø, ikke en levert faks eller et pristilbud. pages_requested er det registrerte antallet sider i kilden; pages_sent viser fremdriften som er registrert under behandlingen. cost er en streng med et desimaltall og kan allerede inneholde et estimat mens jobben står i kø. result inneholder behandlingsdetaljer; webhook_status inneholder den registrerte tilbakekallingsstatusen. Tidsstemplene er serverformaterte strenger uten tidssoneforskyvning.

Spør med stadig lengre intervaller fremfor i en tett løkke. Behandlingen kan rapportere sendt eller fullført status, men den gjeldende gjennomgangen har ikke fastslått noen leveringsgaranti til mottakeren. For et kritisk dokument må du bekrefte mottak med mottakeren før du anser det som levert eller sender en kopi. Livssyklusen til den aktive arbeidsprosessen, de endelige faktureringsreglene og tilbakekallingskontrakten blir fortsatt verifisert. Ikke anta at aksept i køen eller en jobb-ID som ikke er tom, betyr levering.

Feil

API-kode 400 betyr manglende eller feil utformet job_id; 401 betyr manglende autentisering; 404 betyr at jobben ikke ble funnet for denne kontoen. Ikke utled eierskap bare fra identifikatoren.