Lista utgående faxjobb

Lista utgående faxjobb

Använd ett aktiverat MultiTEL API-konto via HTTPS med kontots konfigurerade inloggningsuppgifter och IP-begränsningar. Den här ändpunkten listar utgående faxposter som tillhör det autentiserade kontot. Att hämta listan skickar inte något fax och skickar inte heller om något fax.

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

Den här hanteraren stöder inte filtren date_from eller date_to. Portalens utkorg har ytterligare filter som inte ska kopieras till denna API-begäran. Resultaten sorteras efter när de skapades, med de nyaste först, utan sekundär sortering efter ID eller någon markör för en ögonblicksbild.

Läs jobbposter

Läs både HTTP-resultatet och status.code i JSON. Ett lyckat svar innehåller response.faxes och response.pagination; exemplet använder fiktiva uppgifter. En tom faxbrevlåda returnerar en tom faxes-array med total 0 och total_pages 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 är postens numeriska ID. uuid är den synliga jobbidentifieraren; använd det jobb-ID som returneras av send_fax vid nya inskickningar och spara det för regelbunden statuskontroll. Listan kan innehålla äldre poster, så utgå inte från att varje rad skapades via samma ändpunkt för inskickning.

status och result_text innehåller den registrerade bearbetningsstatusen och det registrerade meddelandet. Den här listningen normaliserar dem inte till en fullständig uppsättning uppräknade leveransstatusvärden. Kölagd betyder kölagd, inte levererad. För viktiga dokument ska du bekräfta mottagandet med mottagaren innan du betraktar faxet som levererat eller skickar in en dubblett.

pages_requested och pages_sent är numeriska antal. cost behåller det lagrade värdet och använder strängen 0.00 som reservvärde; utgå inte från att det har samma JSON-typ som kostnaden i inkorgen. En kölagd post kan redan innehålla en uppskattning. Varken det värdet eller en post i listan fastställer den slutliga faktureringen.

created_at, sent_at och updated_at är lagrade värden i serverns format utan tidszonsförskjutning; sent_at kan vara null. Listan utelämnar fältet för webhook-status som returneras av den separata statusändpunkten.

Stäm av resultatsidor på ett säkert sätt

Följ pagination.page, limit, total och total_pages. Sidor efter den sista sidan kan vara tomma. Nya jobb kan flytta poster mellan sidor medan du bläddrar. Behåll jobbidentifierarna när du slår ihop sidor; den här ändpunkten garanterar inte en oföränderlig ögonblicksbild.

Integritet och nya försök

Utkorgens poster innehåller privata telefonmetadata. Begränsa vilka som kan läsa dem och undvik att logga fullständiga svar. Att en post saknas i listan bevisar inte att en sändningsbegäran misslyckades: kontrollera det sparade jobb-ID:t och portalens utkorg innan du skickar in på nytt. En ny sändning kan skapa ytterligare ett fax som kan debiteras. De slutliga garantierna för bakgrundsbearbetning, fakturering, återanrop och lagringstid granskas fortfarande.