Listimi i fakseve të marra

Përdorni një llogari API MultiTEL të aktivizuar përmes HTTPS, me kredencialet dhe kufizimet IP të konfiguruara për të. Kjo pikë fundore liston fakset e marra që i përkasin llogarisë së autentikuar. Ajo nuk dërgon faks dhe as nuk shkarkon dokumentin e tij.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

Parametrat e kërkesës për kutinë hyrëse
Parametri	I detyrueshëm	Kuptimi
`page`	Jo	Numri i faqes, duke filluar nga 1. Vlera e parazgjedhur: 1.
`limit`	Jo	Regjistrime për faqe. Vlera e parazgjedhur: 25; maksimumi: 100. Përdorni një numër të plotë pozitiv.
`search`	Jo	Kërkon te numri i dërguesit, numri i faksit marrës dhe identifikuesi i stacionit në distancë. Hapësirat në fillim dhe në fund hiqen. Dallimi mes shkronjave të mëdha dhe të vogla varet nga rregullat e krahasimit të bazës së të dhënave.
`date_from`	Jo	Përfshini fakset nga fillimi i kësaj dite sipas orës lokale të serverit. Përdorni YYYY-MM-DD.
`date_to`	Jo	Përfshini fakset deri në fund të kësaj dite sipas orës lokale të serverit. Përdorni YYYY-MM-DD.

Kufijtë e datave përfshihen dhe përdorin interpretimin e datës nga serveri API, jo një zonë kohore të kërkuar nga përdoruesi. Vargjet e pavlefshme të datave mund të shpërfillen në vend që të refuzohen; kontrolloni vlefshmërinë e tyre përpara dërgimit. Pa filtra datash, komponenti që trajton kërkesën nuk vendos asnjë interval datash të parazgjedhur. Rezultatet renditen sipas kohës së marrjes, me më të rejat në fillim. Pika fundore nuk ofron një pamje të qëndrueshme të të dhënave ndërmjet faqeve: fakset e reja mund t'i zhvendosin regjistrimet nga një faqe në tjetrën.

Leximi i faqes së kutisë hyrëse

Lexoni rezultatin HTTP dhe fushën status.code në JSON. Dështimet në pjesë të tjera të API mund të përdorin një strukturë gabimi JSON edhe kur kodi i statusit HTTP është 200. Një përgjigje e suksesshme përmban response.faxes dhe response.pagination. Ky shembull përdor vlera të sajuara.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id është identifikuesi numerik i regjistrimit në kutinë hyrëse. hash është paraqitja e tij MD5 për rrjedhën e vjetër të punës me dokumentet hyrëse; nuk është identifikues i një detyre send_fax dhe as kredencial autorizimi. Mos e përdorni me pikën fundore fax_status për fakset dalëse.

received_timestamp është vula kohore Unix e ruajtur. received_at është një vulë kohore e formatuar nga serveri pa zhvendosje të zonës kohore, ose null nëse nuk është regjistruar koha e marrjes; përdorni vlerën Unix kur shfaqni kohët në zonën tuaj kohore. cost është një numër JSON, jo një ofertë çmimi apo dëshmi e një tarifimi të veçantë të përfunduar.

status ka vlerën success vetëm kur kodi i ruajtur i statusit është zero; vlerat e tjera bëhen failed. status_text përmban mesazhin e ruajtur të përpunimit, me OK ose Failed si vlerë rezervë. emailed ruan vlerën e regjistruar në vend të një vlere logjike. viewed është një vlerë logjike. Mos nxirrni përfundimin se dërgimi me email ka pasur sukses vetëm nga statusi i faksit.

Trajtimi i listave boshe dhe i listave që ndryshojnë

Një kuti hyrëse boshe kthen një varg faxes bosh, total 0 dhe total_pages 0. Një faqe përtej faqes së fundit mund të kthejë gjithashtu një varg bosh. Ndaloni sipas fushave të ndarjes në faqe, pa supozuar se ekziston të paktën një faqe. Nuk vihet në dispozicion as kursor dhe as renditje dytësore sipas identifikuesit të regjistrimit. Ruani identifikuesit e regjistrimeve kur rakordoni faqe që kanë regjistrime të përbashkëta.

Qasja në dokumente dhe privatësia

Regjistrimet e kutisë hyrëse përmbajnë të dhëna përshkruese private për telefonat dhe dokumentet. Kufizoni qasjen në aplikacionin tuaj dhe shmangni ruajtjen e përgjigjeve të plota në regjistrat e veprimtarisë. Listimi nuk e shënon një dokument si të parë. Përdorni fax_file për shkarkimin e dokumenteve hyrëse përmes mekanizmit të përputhshmërisë, duke pasur parasysh se ai e shënon një regjistrim ekzistues hyrës si të parë edhe nëse skedari i tij nuk është i disponueshëm. Kutia hyrëse e portalit është gjithashtu e disponueshme për qasje në dokumente. Nuk është përcaktuar asnjë garanci për ruajtjen e skedarëve.