Sprawdź status zadania faksu

Wyszukaj swoje zadanie

Użyj włączonego konta MultiTEL API. Wyślij dane uwierzytelniające HTTP Basic dla konta z hasłem lub token Bearer dla konta z tokenem. Uprawnienia konta i ograniczenia IP nadal obowiązują. Nie używaj wewnętrznych danych uwierzytelniających workera.

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

job_id jest wymagane i musi być 32-znakowym identyfikatorem szesnastkowym zwróconym przez send_fax. Skopiuj go dokładnie. Żądania są ograniczone do uwierzytelnionego właściciela.

Odczytaj wynik

Odczytaj zarówno wynik HTTP, jak i JSON status.code. Błędy JSON mogą nadejść z HTTP 200. Pomyślna odpowiedź JSON zawiera status oraz response; przykłady używają fikcyjnych danych.

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

Przykład to zadanie w kolejce, a nie dostarczony faks ani oferta cenowa. pages_requested to wykryta liczba stron źródła; pages_sent zgłasza postęp zarejestrowany przez przetwarzanie. cost to ciąg dziesiętny i może już zawierać oszacowanie, gdy zadanie jest w kolejce. result zawiera szczegóły przetwarzania; webhook_status zawiera zarejestrowany stan wywołania zwrotnego. Znaczniki czasu to sformatowane przez serwer ciągi bez przesunięcia strefy czasowej.

Odpytuj z rosnącymi interwałami zamiast w ciasnej pętli. Przetwarzanie może zgłosić stan wysłany lub ukończony, ale bieżący audyt nie ustalił gwarancji dostarczenia do odbiorcy. W przypadku dokumentu krytycznego potwierdź odbiór u odbiorcy, zanim uznasz go za dostarczony lub wyślesz duplikat. Aktywny cykl życia workera, ostateczne zasady rozliczeń i kontrakt wywołań zwrotnych są nadal weryfikowane. Nie zakładaj, że przyjęcie do kolejki lub niepusty identyfikator zadania oznacza dostarczenie.

Błędy

API kod 400 oznacza brakujące lub nieprawidłowe job_id; 401 oznacza brak uwierzytelnienia; 404 oznacza, że nie znaleziono zadania dla tego konta. Nie wnioskuj o własności wyłącznie z identyfikatora.