Listarea operațiunilor de trimitere a faxurilor

Listarea operațiunilor de trimitere a faxurilor

Utilizați un cont API MultiTEL activat, prin HTTPS, cu datele de autentificare și restricțiile IP configurate pentru acesta. Acest punct de acces listează înregistrările faxurilor de ieșire care aparțin contului autentificat. Listarea nu transmite și nu retrimite niciun fax.

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

Acest gestionar de cereri nu acceptă filtrele date_from sau date_to. Secțiunea de faxuri de ieșire a portalului are filtre suplimentare care nu trebuie copiate în această cerere API. Rezultatele sunt ordonate după momentul creării, cele mai noi fiind primele, fără o sortare secundară după identificator sau un cursor pentru un instantaneu al datelor.

Consultarea înregistrărilor operațiunilor

Consultați atât rezultatul HTTP, cât și câmpul status.code din JSON. Un răspuns reușit conține response.faxes și response.pagination; exemplul folosește date fictive. O căsuță poștală goală returnează un tablou faxes gol, cu 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 este identificatorul numeric al înregistrării. uuid este identificatorul vizibil al operațiunii; utilizați identificatorul operațiunii returnat de send_fax pentru trimiteri noi și păstrați-l pentru verificarea periodică a stării. Lista poate include înregistrări mai vechi, așadar nu presupuneți că fiecare rând a fost creat prin același punct de acces pentru trimitere.

status și result_text conțin starea și mesajul de procesare înregistrate. Această listare nu le normalizează într-o enumerare completă a stărilor de livrare. În așteptare înseamnă în așteptare, nu livrat. Pentru documentele esențiale, confirmați primirea cu destinatarul înainte de a considera faxul livrat sau de a trimite un duplicat.

pages_requested și pages_sent sunt valori numerice care indică numărul de pagini. cost păstrează valoarea stocată, folosind șirul de caractere 0.00 ca valoare de rezervă; nu presupuneți că are același tip JSON ca valoarea costului din căsuța de intrare. O înregistrare aflată în așteptare poate conține deja o estimare. Nici acea valoare, nici o înregistrare din listă nu stabilesc facturarea finală.

created_at, sent_at și updated_at sunt valori stocate în formatul serverului, fără un decalaj de fus orar; sent_at poate fi null. Lista omite câmpul privind starea notificării webhook, returnat de punctul de acces separat pentru stare.

Corelarea în siguranță a paginilor de rezultate

Urmăriți pagination.page, limit, total și total_pages. Paginile de după ultima pagină pot fi goale. Operațiunile noi pot muta înregistrări între pagini în timp ce le parcurgeți. Păstrați identificatorii operațiunilor când combinați paginile; acest punct de acces nu garantează un instantaneu stabil al datelor.

Confidențialitate și reîncercări

Înregistrările faxurilor de ieșire conțin metadate telefonice confidențiale. Limitați persoanele care le pot consulta și evitați înregistrarea răspunsurilor complete în jurnale. Absența unei înregistrări din listă nu dovedește că o cerere de trimitere a eșuat: verificați identificatorul păstrat al operațiunii și secțiunea de faxuri de ieșire din portal înainte de a retrimite cererea. O nouă trimitere poate crea un alt fax care ar putea fi facturat. Garanțiile definitive privind procesul de lucru, facturarea, apelurile de revenire și păstrarea datelor sunt încă în curs de revizuire.