Kontrollér status for et faxjob

Find dit job

Brug en aktiveret MultiTEL API-konto. Send HTTP Basic-loginoplysninger for en adgangskodekonto eller et Bearer-token for en tokenkonto. Kontotilladelser og IP-begrænsninger gælder stadig. Brug ikke interne loginoplysninger til arbejdsprocessen.

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åkrævet og skal være den hexadecimale identifikator på 32 tegn, som send_fax returnerer. Kopiér den nøjagtigt. Anmodninger er begrænset til den autentificerede ejer.

Læs resultatet

Læs både HTTP-resultatet og feltet status.code i JSON. JSON-fejl kan komme med HTTP 200. Et vellykket JSON-svar indeholder status og response; eksemplerne bruger 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 viser et job i kø, ikke en leveret fax eller et pristilbud. pages_requested er det registrerede antal sider i kilden; pages_sent viser den fremdrift, der er registreret under behandlingen. cost er en streng med et decimaltal og kan allerede indeholde et estimat, mens jobbet står i kø. result indeholder behandlingsdetaljer; webhook_status indeholder den registrerede callbackstatus. Tidsstempler er serverformaterede strenge uden tidszoneforskydning.

Forespørg med stigende intervaller i stedet for i en tæt løkke. Behandlingen kan vise en sendt eller afsluttet status, men den aktuelle gennemgang har ikke fastslået en garanti for levering til modtageren. Ved et kritisk dokument skal du bekræfte modtagelsen med modtageren, før du anser det for leveret eller sender en kopi igen. Den aktive arbejdsproces, de endelige faktureringsregler og callbackkontrakten bliver stadig kontrolleret. Antag ikke, at accept i køen eller et ikke-tomt job-id betyder levering.

Fejl

API-kode 400 betyder manglende eller forkert formateret job_id; 401 betyder manglende autentificering; 404 betyder, at jobbet ikke blev fundet for denne konto. Udled ikke ejerskab alene fra identifikatoren.