Popis primljenih faksova

Upotrijebite aktiviran MultiTEL API račun putem protokola HTTPS s njegovim konfiguriranim vjerodajnicama i IP ograničenjima. Ova krajnja točka prikazuje popis primljenih faksova koji pripadaju autentificiranom računu. Ne šalje faks niti preuzima njegov dokument.

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

Parametri upita za ulazni pretinac
Parametar	Obvezno	Značenje
`page`	Ne	Broj stranice, počevši od 1. Zadana vrijednost: 1.
`limit`	Ne	Broj zapisa po stranici. Zadana vrijednost: 25; najviše: 100. Upotrijebite pozitivan cijeli broj.
`search`	Ne	Pretražuje broj pošiljatelja, broj primatelja faksa i identifikator udaljene stanice. Razmaci na početku i kraju uklanjaju se. Razlikovanje velikih i malih slova ovisi o pravilima usporedbe u bazi podataka.
`date_from`	Ne	Uključite faksove od početka ovog dana prema lokalnom vremenu poslužitelja. Upotrijebite YYYY-MM-DD.
`date_to`	Ne	Uključite faksove zaključno s krajem ovog dana prema lokalnom vremenu poslužitelja. Upotrijebite YYYY-MM-DD.

Granični datumi uključeni su u raspon i tumače se prema API poslužitelju, a ne prema zatraženoj korisničkoj vremenskoj zoni. Nevaljani nizovi znakova za datum mogu biti zanemareni umjesto odbijeni; provjerite njihovu valjanost prije slanja. Bez filtara datuma obrađivač ne postavlja zadani datumski raspon. Rezultati su poredani prema vremenu primitka, od najnovijih prema najstarijima. Krajnja točka ne pruža stabilnu snimku stanja kroz sve stranice: novi dolasci mogu premjestiti zapise s jedne stranice na drugu.

Pročitajte stranicu pretinca

Pročitajte rezultat protokola HTTP i polje status.code u formatu JSON. Pogreške drugdje u API sučelju mogu biti prikazane omotnicom pogreške u formatu JSON čak i kada je status protokola HTTP 200. Uspješan odgovor sadrži response.faxes i response.pagination. U ovom se primjeru upotrebljavaju izmišljene vrijednosti.

{
  "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 je brojčani identifikator zapisa u ulaznom pretincu. hash je njegov prikaz u obliku MD5 za naslijeđeni tijek rada s dolaznim dokumentima; nije identifikator zadatka send_fax niti vjerodajnica za autorizaciju. Nemojte ga upotrebljavati s krajnjom točkom za odlazne faksove fax_status.

received_timestamp je pohranjena Unix vremenska oznaka. received_at je vremenska oznaka koju je oblikovao poslužitelj, bez pomaka vremenske zone, ili null ako vrijeme primitka nije zabilježeno; pri prikazu vremena u vlastitoj vremenskoj zoni upotrijebite Unix vrijednost. cost je broj u formatu JSON, a ne ponuda cijene niti dokaz zasebne izvršene naplate.

status ima vrijednost success samo ako je pohranjeni kod statusa nula; ostale vrijednosti postaju failed. status_text sadrži pohranjenu poruku o obradi, uz OK ili Failed kao zamjensku vrijednost. emailed zadržava pohranjenu vrijednost umjesto logičke vrijednosti. viewed je logička vrijednost. Nemojte zaključivati da je e-pošta uspješno isporučena isključivo na temelju statusa faksa.

Obrada praznih i promjenjivih popisa

Prazan pretinac vraća prazno polje faxes, total 0 i total_pages 0. Stranica nakon posljednje također može vratiti prazno polje. Prestanite dohvaćati prema poljima za podjelu na stranice umjesto da pretpostavite da postoji barem jedna stranica. Nisu dostupni ni pokazivač ni sekundarno sortiranje prema identifikatoru zapisa. Sačuvajte identifikatore zapisa pri usklađivanju stranica koje se preklapaju.

Pristup dokumentima i privatnost

Zapisi u pretincu sadrže privatne metapodatke o telefonskim brojevima i dokumentima. Ograničite pristup u svojoj aplikaciji i izbjegavajte bilježenje cijelih odgovora u zapisnike. Dohvaćanje popisa ne označava dokument kao pregledan. Upotrijebite fax_file za preuzimanje dolaznih dokumenata radi kompatibilnosti, uz napomenu da time postojeći dolazni zapis postaje označen kao pregledan čak i ako njegova datoteka nije dostupna. Dokumentima možete pristupiti i putem ulaznog pretinca na portalu. Nije utvrđeno jamstvo čuvanja datoteka.