Wyświetlanie zadań faksów wychodzących

Wyświetlanie zadań faksów wychodzących

Korzystaj z aktywnego konta API MultiTEL przez HTTPS, używając skonfigurowanych dla niego danych uwierzytelniających i ograniczeń adresów IP. Ten punkt końcowy wyświetla rekordy faksów wychodzących należące do uwierzytelnionego konta. Wyświetlenie listy nie powoduje wysłania ani ponownego wysłania faksu.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Ten mechanizm obsługi nie obsługuje filtrów date_from ani date_to. Skrzynka nadawcza w portalu udostępnia dodatkowe filtry, których nie należy kopiować do tego żądania API. Wyniki są uporządkowane według czasu utworzenia, od najnowszych, bez dodatkowego sortowania według identyfikatora ani kursora migawki danych.

Odczytywanie rekordów zadań

Sprawdzaj zarówno wynik HTTP, jak i status.code w JSON. Pomyślna odpowiedź zawiera response.faxes i response.pagination; w przykładzie użyto fikcyjnych danych. W przypadku pustej skrzynki zwracana jest pusta tablica faxes z total równym 0 i total_pages równym 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id to liczbowy identyfikator rekordu. uuid to widoczny identyfikator zadania; używaj identyfikatora zadania zwróconego przez send_fax dla nowych zleceń i zachowaj go do okresowego sprawdzania statusu. Lista może zawierać starsze rekordy, więc nie zakładaj, że każdy wiersz został utworzony za pośrednictwem tego samego punktu końcowego do przesyłania zleceń.

status i result_text zawierają zapisany stan przetwarzania i komunikat. Ta lista nie normalizuje ich do kompletnego zestawu wartości wyliczeniowych stanów doręczenia. W kolejce oznacza w kolejce, a nie doręczony. W przypadku ważnych dokumentów potwierdź odbiór u odbiorcy, zanim uznasz faks za doręczony lub zlecisz wysłanie jego kolejnej kopii.

pages_requested i pages_sent to wartości liczbowe określające liczbę stron. cost zachowuje zapisaną wartość, z zastępczą wartością tekstową 0.00; nie zakładaj, że ma taki sam typ JSON jak koszt w skrzynce odbiorczej. Rekord oczekujący w kolejce może już zawierać szacunkowy koszt. Ani ta wartość, ani wpis na liście nie określają ostatecznego rozliczenia.

created_at, sent_at i updated_at to zapisane wartości w formacie serwera bez przesunięcia strefy czasowej; sent_at może mieć wartość null. Lista pomija pole statusu powiadomienia webhook zwracane przez osobny punkt końcowy statusu.

Bezpieczne uzgadnianie wyników z kolejnych stron

Kieruj się wartościami pagination.page, limit, total i total_pages. Strony o numerach wyższych niż ostatnia strona mogą być puste. Nowe zadania mogą powodować przesuwanie wpisów między stronami podczas przeglądania. Zachowuj identyfikatory zadań podczas łączenia wyników ze stron; ten punkt końcowy nie gwarantuje niezmiennej migawki danych.

Prywatność i ponawianie prób

Rekordy skrzynki nadawczej zawierają prywatne metadane telefoniczne. Ogranicz dostęp do ich odczytu i unikaj zapisywania pełnych odpowiedzi w dziennikach. Brak wpisu na liście nie dowodzi, że żądanie wysłania zakończyło się niepowodzeniem: przed ponownym zleceniem sprawdź zachowany identyfikator zadania i skrzynkę nadawczą w portalu. Nowe zlecenie wysłania może utworzyć kolejny faks, za który potencjalnie zostanie naliczona opłata. Ostateczne gwarancje dotyczące procesu roboczego, rozliczeń, powiadomień zwrotnych i przechowywania danych są nadal weryfikowane.