Lys uitgaande fakstake

Gebruik 'n geaktiveerde MultiTEL-API-rekening oor HTTPS met die aanmeldbesonderhede en IP-beperkings wat daarvoor opgestel is. Hierdie eindpunt lys uitgaande faksrekords wat aan die geoutentiseerde rekening behoort. Die lysbewerking versend of herversend geen faks nie.

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

Navraagparameters vir die uitmandjie
Parameter	Vereis	Betekenis
`page`	Nee	Bladsynommer, vanaf 1. Verstek: 1.
`limit`	Nee	Rekords per bladsy. Verstek: 25; maksimum: 100. Gebruik 'n positiewe heelgetal.
`search`	Nee	Deursoek die versendernommer, bestemmingsnommer en die taak se UUID. Spasies aan die begin en einde word verwyder. Dit deursoek nie die status of resultaatteks nie.

Hierdie hanteerder ondersteun nie date_from- of date_to-filters nie. Die portaal se uitmandjie het bykomende filters wat nie na hierdie API-versoek gekopieer moet word nie. Resultate word volgens skeppingstyd gerangskik, met die nuutstes eerste, sonder sekondêre sortering volgens ID of 'n momentopnamewyser.

Lees taakrekords

Lees sowel die HTTP-resultaat as die JSON-veld status.code. 'n Suksesvolle antwoord bevat response.faxes en response.pagination; die voorbeeld gebruik fiktiewe data. 'n Leë posbus lewer 'n leë faxes-skikking met total 0 en total_pages 0 terug.

{
  "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 is die numeriese rekord-ID. uuid is die sigbare taakidentifiseerder; gebruik die taak-ID wat deur send_fax vir nuwe indienings teruggelewer word en bewaar dit vir periodieke statusnavrae. Die lys kan ouer rekords insluit; moet dus nie aanneem dat elke ry deur dieselfde indieningseindpunt geskep is nie.

status en result_text bevat die aangetekende verwerkingstoestand en boodskap. Hierdie lysbewerking normaliseer hulle nie tot 'n volledige enumerasie van afleweringstoestande nie. In die waglys beteken in die waglys, nie afgelewer nie. Bevestig vir kritieke dokumente die ontvangs by die ontvanger voordat jy die faks as afgelewer beskou of 'n duplikaat indien.

pages_requested en pages_sent is numeriese tellings. cost behou die gestoorde waarde, met die terugvalwaarde 0.00 as 'n string; moenie aanneem dat dit dieselfde JSON-tipe as die inmandjie se koste het nie. 'n Rekord in die waglys kan reeds 'n raming bevat. Nóg daardie waarde nóg 'n inskrywing in die lys bevestig finale fakturering.

created_at, sent_at en updated_at is gestoorde waardes in die bediener se formaat sonder 'n tydsone-afwyking; sent_at kan null wees. Die lys laat die webhaakstatusveld weg wat deur die afsonderlike statuseindpunt teruggelewer word.

Versoen bladsye veilig

Volg pagination.page, limit, total en total_pages. Bladsye ná die laaste bladsy kan leeg wees. Nuwe take kan inskrywings tussen bladsye verskuif terwyl jy blaai. Behou taakidentifiseerders wanneer jy bladsye saamvoeg; hierdie eindpunt waarborg nie 'n stabiele momentopname nie.

Privaatheid en herpogings

Uitmandjierekords bevat private telefoonmetadata. Beperk wie dit kan lees en vermy die aantekening van volledige antwoorde in logboeke. 'n Ontbrekende lysinskrywing bewys nie dat 'n versendingsversoek misluk het nie: gaan die bewaarde taak-ID en die portaal se uitmandjie na voordat jy weer indien. 'n Nuwe versending kan nog 'n faks skep waarvoor moontlik 'n bedrag gehef kan word. Finale waarborge oor die agtergrondverwerker, fakturering, terugroepe en bewaring word nog hersien.