Izejošo faksa uzdevumu saraksts

Izejošo faksa uzdevumu saraksts

Izmantojiet iespējotu MultiTEL API kontu ar tam konfigurētajiem piekļuves datiem un IP ierobežojumiem, savienojumam lietojot HTTPS. Šis galapunkts uzskaita autentificētajam kontam piederošos izejošo faksu ierakstus. Saraksta iegūšana nenosūta faksu un nenosūta to atkārtoti.

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

Šis apstrādātājs neatbalsta filtrus date_from vai date_to. Portāla izejošo faksu sarakstā ir papildu filtri, kurus nevajadzētu pārkopēt šajā API pieprasījumā. Rezultāti tiek kārtoti pēc izveides laika, jaunākie vispirms, bez papildu kārtošanas pēc identifikatora vai momentuzņēmuma kursora.

Uzdevumu ierakstu lasīšana

Pārbaudiet gan HTTP rezultātu, gan JSON lauku status.code. Veiksmīga atbilde satur response.faxes un response.pagination; piemērā izmantoti izdomāti dati. Tukšai pastkastei tiek atgriezts tukšs faxes masīvs ar total vērtību 0 un total_pages vērtību 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 ir ieraksta skaitliskais identifikators. uuid ir redzamais uzdevuma identifikators; jauniem nosūtīšanas pieprasījumiem izmantojiet uzdevuma identifikatoru, ko atgriež send_fax, un saglabājiet to turpmākai periodiskai statusa pārbaudei. Sarakstā var būt arī senāki ieraksti, tāpēc nepieņemiet, ka katra rinda ir izveidota, izmantojot vienu un to pašu nosūtīšanas galapunktu.

status un result_text satur reģistrēto apstrādes stāvokli un ziņojumu. Šis saraksts tos nenormalizē pilnā piegādes stāvokļu uzskaitījumā. Ievietots rindā nozīmē, ka fakss ir rindā, nevis piegādāts. Svarīgu dokumentu gadījumā apstipriniet saņemšanu ar saņēmēju, pirms uzskatāt faksu par piegādātu vai iesniedzat dublikātu.

pages_requested un pages_sent ir skaitliskas skaita vērtības. cost saglabā datubāzē glabāto vērtību, bet rezerves vērtība ir virkne 0.00; nepieņemiet, ka tai ir tāds pats JSON tips kā ienākošo faksu izmaksām. Rindā ievietotā ierakstā jau var būt izmaksu aplēse. Ne šī vērtība, ne ieraksta esamība sarakstā neapstiprina galīgo maksu.

created_at, sent_at un updated_at ir saglabātas vērtības servera formātā bez laika joslas nobīdes; sent_at vērtība var būt null. Sarakstā nav tīmekļa aizķeres statusa lauka, ko atgriež atsevišķais statusa galapunkts.

Droša rezultātu lapu saskaņošana

Ņemiet vērā pagination.page, limit, total un total_pages vērtības. Lapas aiz pēdējās lapas var būt tukšas. Pārlūkošanas laikā jauni uzdevumi var pārvietot ierakstus starp lapām. Apvienojot lapas, saglabājiet uzdevumu identifikatorus; šis galapunkts negarantē stabilu momentuzņēmumu.

Privātums un atkārtoti mēģinājumi

Izejošo faksu ieraksti satur privātus tālruņu metadatus. Ierobežojiet personu loku, kas tos var lasīt, un izvairieties no pilnu atbilžu ierakstīšanas žurnālos. Ieraksta neesamība sarakstā nepierāda, ka nosūtīšanas pieprasījums ir neizdevies: pirms atkārtotas iesniegšanas pārbaudiet saglabāto uzdevuma identifikatoru un portāla izejošo faksu sarakstu. Jauna nosūtīšana var izveidot vēl vienu faksu, par kuru var tikt iekasēta maksa. Galīgās garantijas attiecībā uz fona apstrādi, norēķiniem, atzvaniem un datu glabāšanu vēl tiek pārskatītas.