Vis udgående faxjob

Vis udgående faxjob

Brug en aktiveret MultiTEL API-konto via HTTPS med de konfigurerede legitimationsoplysninger og IP-begrænsninger. Dette endepunkt viser udgående faxposter, der tilhører den autentificerede konto. Visning af listen sender eller gensender ikke en 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

Denne anmodningsbehandler understøtter ikke filtrene date_from eller date_to. Portalens udbakke har yderligere filtre, som ikke bør kopieres til denne API-anmodning. Resultaterne sorteres efter oprettelsestidspunkt med de nyeste først, uden sekundær sortering efter ID eller en markør til et øjebliksbillede.

Læs jobposter

Læs både HTTP-resultatet og status.code i JSON. Et vellykket svar indeholder response.faxes og response.pagination; eksemplet bruger fiktive data. En tom postkasse returnerer et tomt faxes-array 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 postens numeriske ID. uuid er den synlige jobidentifikator; brug det job-ID, der returneres af send_fax ved nye indsendelser, og gem det til løbende statusforespørgsler. Listen kan indeholde ældre poster, så antag ikke, at alle rækker er oprettet via det samme indsendelsesendepunkt.

status og result_text indeholder den registrerede behandlingsstatus og meddelelse. Denne liste normaliserer dem ikke til et komplet sæt af mulige leveringsstatusværdier. I kø betyder i kø, ikke leveret. Ved kritiske dokumenter skal du bekræfte modtagelsen med modtageren, før du betragter faxen som leveret eller indsender en dublet.

pages_requested og pages_sent er numeriske antal. cost bevarer den lagrede værdi og bruger tekststrengen 0.00 som reserveværdi; antag ikke, at den har samme JSON-type som omkostningen i indbakken. En post i kø kan allerede indeholde et estimat. Hverken denne værdi eller en post på listen fastslår den endelige fakturering.

created_at, sent_at og updated_at er lagrede værdier i serverens format uden tidszoneforskydning; sent_at kan være null. Listen udelader feltet for webhookstatus, som returneres af det separate statusendepunkt.

Sammenhold resultatsiderne sikkert

Følg pagination.page, limit, total og total_pages. Sider efter den sidste side kan være tomme. Nye job kan flytte poster mellem sider, mens du gennemser dem. Bevar jobidentifikatorerne, når du samler siderne; dette endepunkt garanterer ikke et stabilt øjebliksbillede.

Privatliv og nye forsøg

Udbakkeposter indeholder private telefonmetadata. Begræns, hvem der kan læse dem, og undgå at logge komplette svar. En manglende post på listen beviser ikke, at en afsendelsesanmodning mislykkedes: Kontrollér det gemte job-ID og portalens udbakke, før du indsender igen. En ny afsendelse kan oprette endnu en fax, som potentielt kan blive faktureret. De endelige garantier for baggrundsprocessen, fakturering, tilbagekald og opbevaring er stadig under gennemgang.