Listimi i detyrave të dërgimit të fakseve

Listimi i detyrave të dërgimit të fakseve

Përdorni një llogari të aktivizuar të API të MultiTEL përmes HTTPS, me kredencialet dhe kufizimet IP të konfiguruara për të. Kjo pikë fundore liston regjistrimet e fakseve dalëse që i përkasin llogarisë së autentikuar. Listimi nuk transmeton dhe nuk ridërgon asnjë faks.

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

Ky përpunues kërkesash nuk mbështet filtrat date_from ose date_to. Seksioni i fakseve dalëse në portal ka filtra shtesë që nuk duhen kopjuar në këtë kërkesë API. Rezultatet renditen sipas kohës së krijimit, me më të rejat në fillim, pa renditje dytësore sipas identifikuesit ose kursor të një pamjeje të çastit të të dhënave.

Leximi i regjistrimeve të detyrave

Lexoni si rezultatin HTTP, ashtu edhe fushën status.code në JSON. Një përgjigje e suksesshme përmban response.faxes dhe response.pagination; shembulli përdor të dhëna të sajuara. Një kuti postare bosh kthen një varg faxes bosh, me total 0 dhe 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 është identifikuesi numerik i regjistrimit. uuid është identifikuesi i dukshëm i detyrës; përdorni identifikuesin e detyrës të kthyer nga send_fax për dërgesat e reja dhe ruajeni për kontrollimin periodik të gjendjes. Lista mund të përfshijë regjistrime më të vjetra, prandaj mos supozoni se çdo rresht është krijuar përmes së njëjtës pikë fundore dërgimi.

status dhe result_text përmbajnë gjendjen dhe mesazhin e regjistruar të përpunimit. Ky listim nuk i normalizon ato në një bashkësi të plotë vlerash të numëruara për gjendjen e dorëzimit. Në radhë do të thotë në radhë, jo i dorëzuar. Për dokumente kritike, konfirmoni marrjen me marrësin përpara se ta konsideroni faksin të dorëzuar ose të dërgoni një kopje tjetër.

pages_requested dhe pages_sent janë numërime numerike. cost ruan vlerën e regjistruar, duke përdorur vargun e tekstit 0.00 si vlerë rezervë; mos supozoni se ka të njëjtin tip JSON si kostoja në kutinë hyrëse. Një regjistrim në radhë mund të përmbajë tashmë një vlerësim. As ajo vlerë dhe as një regjistrim në listë nuk përcaktojnë faturimin përfundimtar.

created_at, sent_at dhe updated_at janë vlera të ruajtura në formatin e serverit, pa zhvendosje të zonës kohore; sent_at mund të jetë null. Lista nuk përfshin fushën e gjendjes së webhook-ut që kthehet nga pika fundore e veçantë për gjendjen.

Përputhja e sigurt e faqeve të rezultateve

Ndiqni pagination.page, limit, total dhe total_pages. Faqet pas faqes së fundit mund të jenë bosh. Detyrat e reja mund t'i zhvendosin regjistrimet midis faqeve ndërsa i shfletoni. Ruani identifikuesit e detyrave kur bashkoni faqet; kjo pikë fundore nuk garanton një pamje të çastit të qëndrueshme të të dhënave.

Privatësia dhe riprovimet

Regjistrimet e fakseve dalëse përmbajnë të dhëna përshkruese private të telefonisë. Kufizoni personat që mund t'i lexojnë dhe shmangni regjistrimin e përgjigjeve të plota në ditarë. Mungesa e një regjistrimi në listë nuk provon se një kërkesë dërgimi ka dështuar: kontrolloni identifikuesin e ruajtur të detyrës dhe seksionin e fakseve dalëse në portal përpara se ta ridërgoni kërkesën. Një dërgim i ri mund të krijojë një faks tjetër që mund të faturohet. Garancitë përfundimtare për procesin punues, faturimin, thirrjet e kthimit dhe ruajtjen e të dhënave mbeten në shqyrtim.