Vis utgående faksjobber

Vis utgående faksjobber

Bruk en aktivert MultiTEL-konto for API over HTTPS med kontoens konfigurerte påloggingsopplysninger og IP-begrensninger. Dette endepunktet viser oppføringer for utgående fakser som tilhører den autentiserte kontoen. Å hente listen sender ikke en faks og sender heller ikke en faks på nytt.

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

Denne behandleren støtter ikke filtrene date_from eller date_to. Utboksen i portalen har flere filtre som ikke bør kopieres til denne API-forespørselen. Resultatene sorteres etter opprettelsestidspunkt, med de nyeste først, uten sekundær sortering etter ID eller en markør for et øyeblikksbilde.

Les jobboppføringer

Les både HTTP-resultatet og status.code i JSON-svaret. Et vellykket svar inneholder response.faxes og response.pagination; eksemplet bruker fiktive data. En tom postkasse returnerer en tom faxes-tabell med total 0 og 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 er oppføringens numeriske ID. uuid er den synlige jobbidentifikatoren; ved nye innsendinger bruker du jobb-ID-en som returneres av send_fax og tar vare på den for gjentatte statusforespørsler. Listen kan inneholde eldre oppføringer, så ikke anta at hver rad ble opprettet gjennom det samme endepunktet for innsending.

status og result_text inneholder den registrerte behandlingsstatusen og meldingen. Denne listen normaliserer dem ikke til et fullstendig sett med leveringsstatuser. I kø betyr i kø, ikke levert. For kritiske dokumenter må du få mottaket bekreftet av mottakeren før du regner faksen som levert eller sender inn en kopi.

pages_requested og pages_sent er numeriske antall. cost beholder den lagrede verdien, med strengen 0.00 som reserveverdi; ikke anta at den har samme JSON-type som kostnaden i innboksen. En oppføring i kø kan allerede inneholde et anslag. Verken denne verdien eller en oppføring i listen fastslår den endelige faktureringen.

created_at, sent_at og updated_at er lagrede verdier i serverens format uten tidssoneforskyvning; sent_at kan være null. Listen utelater feltet for webhook-status som returneres av det separate statusendepunktet.

Sammenstill resultatsider på en trygg måte

Følg pagination.page, limit, total og total_pages. Sider etter den siste siden kan være tomme. Nye jobber kan flytte oppføringer mellom sider mens du blar. Ta vare på jobbidentifikatorene når du slår sammen sider; dette endepunktet garanterer ikke et stabilt øyeblikksbilde.

Personvern og nye forsøk

Oppføringer i utboksen inneholder private telefonmetadata. Begrens hvem som kan lese dem, og unngå å loggføre fullstendige svar. En manglende oppføring i listen beviser ikke at en sendeforespørsel mislyktes: kontroller jobb-ID-en du har tatt vare på, og utboksen i portalen før du sender inn på nytt. En ny sending kan opprette enda en faks som kan bli fakturert. Endelige garantier for bakgrunnsprosesser, fakturering, tilbakekall og datalagring er fortsatt under vurdering.