Kimenő faxfeladatok listázása

Kimenő faxfeladatok listázása

Használjon engedélyezett MultiTEL API-fiókot HTTPS-kapcsolaton keresztül, a beállított hitelesítő adatokkal és IP-korlátozásokkal. Ez a végpont a hitelesített fiókhoz tartozó kimenő faxrekordokat listázza. A listázás nem továbbít és nem küld újra faxot.

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

Ez a kéréskezelő nem támogatja a date_from és a date_to szűrőket. A portál kimenőfax-listájának további szűrői is vannak, amelyeket nem szabad átmásolni ebbe az API-kérésbe. A találatok a létrehozás ideje szerint, a legújabbal kezdve jelennek meg, másodlagos azonosító szerinti rendezés és pillanatképhez tartozó kurzor nélkül.

Feladatrekordok kiolvasása

Ellenőrizze a HTTP eredményét és a JSON-válasz status.code mezőjét is. A sikeres válasz tartalmazza a response.faxes és a response.pagination mezőket; a példában kitalált adatok szerepelnek. Üres postafiók esetén üres faxes tömb érkezik, a total értéke 0, a total_pages értéke pedig 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 a rekord numerikus azonosítója. uuid a feladat látható azonosítója; új küldésekhez használja a következő végpont által visszaadott feladatazonosítót: send_fax; őrizze meg ehhez: az állapot rendszeres lekérdezése. A lista régebbi rekordokat is tartalmazhat, ezért ne feltételezze, hogy minden sor ugyanazon a küldési végponton keresztül jött létre.

status és result_text a rögzített feldolgozási állapotot és üzenetet tartalmazza. Ez a lista nem alakítja át őket a kézbesítési állapotok teljes, felsorolt értékkészletére. A sorba állított állapot sorba állítást jelent, nem kézbesítést. Kritikus fontosságú dokumentumoknál erősíttesse meg az átvételt a címzettel, mielőtt a faxot kézbesítettnek tekintené vagy ismételten elküldené.

pages_requested és pages_sent numerikus darabszámok. cost megőrzi a tárolt értéket, és ennek hiányában a 0.00 karakterláncot használja; ne feltételezze, hogy a JSON-típusa megegyezik a bejövő faxok költségének típusával. Egy sorba állított rekord már tartalmazhat becslést. Sem ez az érték, sem egy listabejegyzés nem határozza meg a végleges számlázást.

created_at, sent_at és updated_at a kiszolgáló formátumában tárolt értékek, időzóna-eltolás nélkül; a sent_at értéke null is lehet. A lista nem tartalmazza a külön állapotlekérdező végpont által visszaadott webhookállapot-mezőt.

Találati oldalak biztonságos egyeztetése

Kövesse a pagination.page, limit, total és total_pages mezők értékeit. Az utolsó oldal utáni oldalak üresek lehetnek. Böngészés közben az új feladatok miatt a bejegyzések más oldalakra kerülhetnek. Az oldalak összesítésekor őrizze meg a feladatazonosítókat; ez a végpont nem garantál változatlan pillanatképet.

Adatvédelem és újrapróbálkozások

A kimenő faxok rekordjai bizalmas telefonos metaadatokat tartalmaznak. Korlátozza, hogy ki olvashatja őket, és kerülje a teljes válaszok naplózását. Egy listabejegyzés hiánya nem bizonyítja, hogy a küldési kérés meghiúsult: az újraküldés előtt ellenőrizze a megőrzött feladatazonosítót és a portál kimenőfax-listáját. Egy új küldés újabb, esetlegesen számlázható faxot hozhat létre. A háttérfeldolgozóra, a számlázásra, a visszahívásokra és az adatmegőrzésre vonatkozó végleges garanciák felülvizsgálata még folyamatban van.