Listaa lähtevät faksityöt

Listaa lähtevät faksityöt

Käytä käyttöön otettua MultiTEL API -tiliä HTTPS-yhteydellä sekä tilille määritettyjä tunnistetietoja ja IP-rajoituksia. Tämä päätepiste listaa todennetulle tilille kuuluvat lähtevien faksien tietueet. Listan hakeminen ei lähetä faksia eikä lähetä sitä uudelleen.

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

Tämä käsittelijä ei tue date_from- eikä date_to-suodattimia. Portaalin lähtevien faksien näkymässä on lisäsuodattimia, joita ei pidä kopioida tähän API-pyyntöön. Tulokset järjestetään luontiajan mukaan uusimmat ensin ilman toissijaista tunnisteen mukaista lajittelua tai tilannevedoksen kohdistinta.

Lue töiden tietueet

Lue sekä HTTP-tulos että JSON-vastauksen status.code. Onnistunut vastaus sisältää kentät response.faxes ja response.pagination; esimerkissä käytetään kuvitteellisia tietoja. Tyhjä faksilaatikko palauttaa tyhjän faxes-taulukon, jossa total on 0 ja total_pages on 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 on tietueen numeerinen tunniste. uuid on työn näkyvä tunniste; käytä työn tunnistetta, jonka send_fax palauttaa uusille lähetyksille, ja säilytä se seuraavaa tarkoitusta varten: tilan säännöllinen kysely. Lista voi sisältää vanhempia tietueita, joten älä oleta, että jokainen rivi on luotu saman lähetyspäätepisteen kautta.

status ja result_text sisältävät tallennetun käsittelytilan ja viestin. Tämä listaus ei normalisoi niitä täydelliseksi toimitustilojen luettelotyypiksi. Jonossa tarkoittaa jonossa olevaa, ei toimitettua. Varmista tärkeiden asiakirjojen vastaanotto vastaanottajalta ennen kuin katsot faksin toimitetuksi tai lähetät sen uudelleen.

pages_requested ja pages_sent ovat numeerisia lukumääriä. cost säilyttää tallennetun arvon ja käyttää vara-arvona merkkijonoa 0.00; älä oleta, että sen JSON-tyyppi on sama kuin saapuvien faksien kustannuksen. Jonossa oleva tietue voi jo sisältää arvion. Kyseinen arvo tai listan tietue ei kumpikaan vahvista lopullista laskutusta.

created_at, sent_at ja updated_at ovat tallennettuja arvoja palvelimen käyttämässä muodossa ilman aikavyöhykepoikkeamaa; sent_at voi olla null. Lista ei sisällä webhook-tilakenttää, jonka erillinen tilapäätepiste palauttaa.

Täsmäytä tulossivut turvallisesti

Seuraa kenttiä pagination.page, limit, total ja total_pages. Viimeisen sivun jälkeiset sivut voivat olla tyhjiä. Uudet työt voivat siirtää tietueita sivulta toiselle selaamisen aikana. Säilytä töiden tunnisteet, kun yhdistät sivuja; tämä päätepiste ei takaa muuttumatonta tilannevedosta.

Tietosuoja ja uudelleenyritykset

Lähtevien faksien tietueet sisältävät yksityisiä puhelinmetatietoja. Rajoita niiden lukuoikeuksia ja vältä kokonaisten vastausten kirjaamista lokiin. Tietueen puuttuminen listasta ei todista lähetyspyynnön epäonnistumista: tarkista tallessa oleva työn tunniste ja portaalin lähtevien faksien näkymä ennen uutta lähetyspyyntöä. Uusi lähetys voi luoda toisen faksin, josta saatetaan laskuttaa. Taustakäsittelyä, laskutusta, takaisinkutsuja ja säilytysaikaa koskevat lopulliset takuut ovat edelleen arvioitavina.