Prikaz zadataka odlaznih faksova

Prikaz zadataka odlaznih faksova

Upotrijebite omogućen račun za MultiTEL API putem protokola HTTPS, s njegovim konfiguriranim vjerodajnicama i IP ograničenjima. Ova krajnja točka prikazuje zapise o odlaznim faksovima koji pripadaju autentificiranom računu. Prikaz popisa ne šalje niti ponovno šalje 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

Ovaj obrađivač zahtjeva ne podržava filtre date_from ni date_to. Izlazna pošta na portalu ima dodatne filtre koje ne treba kopirati u ovaj zahtjev prema API-ju. Rezultati su poredani prema vremenu stvaranja, od najnovijeg prema najstarijem, bez dodatnog razvrstavanja prema ID-u ili pokazivača za snimku stanja.

Čitanje zapisa o zadacima

Pročitajte i rezultat protokola HTTP i status.code u JSON-u. Uspješan odgovor sadrži response.faxes i response.pagination; u primjeru se upotrebljavaju izmišljeni podaci. Prazan poštanski sandučić vraća prazno polje faxes uz total 0 i 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 je brojčani ID zapisa. uuid je vidljivi identifikator zadatka; upotrijebite ID zadatka koji vraća send_fax pri novim slanjima i sačuvajte ga za periodičko provjeravanje statusa. Popis može sadržavati starije zapise pa nemojte pretpostaviti da je svaki redak stvoren putem iste krajnje točke za slanje.

status i result_text sadrže zabilježeno stanje obrade i poruku. Ovaj ih popis ne normalizira u potpun skup pobrojanih vrijednosti stanja isporuke. U redu čekanja znači u redu čekanja, a ne isporučeno. Za ključne dokumente potvrdite primitak s primateljem prije nego što faks smatrate isporučenim ili pošaljete duplikat.

pages_requested i pages_sent predstavljaju brojčane količine. cost zadržava pohranjenu vrijednost, uz zamjensku vrijednost 0.00 u obliku niza znakova; nemojte pretpostaviti da ima isti tip podataka u JSON-u kao trošak u ulaznoj pošti. Zapis u redu čekanja već može sadržavati procjenu. Ni ta vrijednost ni stavka na popisu ne utvrđuju konačnu naplatu.

created_at, sent_at i updated_at pohranjene su vrijednosti u formatu poslužitelja bez pomaka vremenske zone; sent_at može biti null. Popis izostavlja polje statusa webhooka koje vraća zasebna krajnja točka za status.

Sigurno usklađivanje stranica rezultata

Pratite pagination.page, limit, total i total_pages. Stranice nakon posljednje stranice mogu biti prazne. Novi zadaci mogu premjestiti stavke s jedne stranice na drugu tijekom pregledavanja. Pri spajanju stranica sačuvajte identifikatore zadataka; ova krajnja točka ne jamči stabilnu snimku stanja.

Privatnost i ponovni pokušaji

Zapisi izlazne pošte sadrže privatne telefonske metapodatke. Ograničite tko ih može čitati i izbjegavajte zapisivanje cjelovitih odgovora u zapisnike. Izostanak stavke s popisa ne dokazuje da zahtjev za slanje nije uspio: prije ponovnog slanja provjerite sačuvani ID zadatka i izlaznu poštu na portalu. Novo slanje može stvoriti još jedan faks koji se može naplatiti. Konačna jamstva za pozadinski proces, naplatu, povratne pozive i čuvanje podataka još se razmatraju.