Siunčiamų faksų užduočių sąrašas

Siunčiamų faksų užduočių sąrašas

Naudokite įgalintą „MultiTEL“ API paskyrą per HTTPS, taikydami jai sukonfigūruotus prisijungimo duomenis ir IP adresų apribojimus. Šis galinis taškas pateikia autentifikuotai paskyrai priklausančių siunčiamų faksų įrašų sąrašą. Sąrašo gavimas fakso neišsiunčia ir pakartotinai nesiunčia.

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

Ši apdorojimo funkcija nepalaiko filtrų date_from ir date_to. Portalo siunčiamų faksų aplanke yra papildomų filtrų, kurių nereikėtų perkelti į šią API užklausą. Rezultatai rikiuojami pagal sukūrimo laiką, pirmiausia pateikiant naujausius, be papildomo rikiavimo pagal identifikatorių ir be duomenų momentinės kopijos žymeklio.

Užduočių įrašų peržiūra

Patikrinkite ir HTTP rezultatą, ir JSON lauką status.code. Sėkmingame atsakyme yra response.faxes ir response.pagination; pavyzdyje naudojami išgalvoti duomenys. Jei faksų aplankas tuščias, grąžinamas tuščias faxes masyvas, o total reikšmė yra 0 ir total_pages reikšmė yra 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 yra skaitinis įrašo identifikatorius. uuid yra matomas užduoties identifikatorius; naujoms siuntimo užklausoms naudokite užduoties identifikatorių, kurį grąžina send_fax funkcija, ir išsaugokite jį, kad galėtumėte atlikti periodines būsenos užklausas. Sąraše gali būti senesnių įrašų, todėl nemanykite, kad kiekviena eilutė sukurta naudojant tą patį siuntimo užklausų galinį tašką.

status ir result_text pateikia įrašytą apdorojimo būseną ir pranešimą. Šiame sąraše jie nesuvienodinami pagal išsamų pristatymo būsenų reikšmių rinkinį. Būsena „eilėje“ reiškia, kad faksas yra eilėje, o ne pristatytas. Jei dokumentai itin svarbūs, prieš laikydami faksą pristatytu arba pateikdami jį pakartotinai, su gavėju patvirtinkite, kad jis gautas.

pages_requested ir pages_sent yra skaitiniai kiekiai. cost išlaiko išsaugotą reikšmę, o jei jos nėra, naudojama eilutė 0.00; nemanykite, kad šio lauko JSON tipas toks pat kaip gautų faksų kainos lauko. Eilėje esančiame įraše jau gali būti numatoma kaina. Nei ši reikšmė, nei įrašo buvimas sąraše nepatvirtina galutinės mokėtinos sumos.

created_at, sent_at ir updated_at yra išsaugotos serverio formatu pateiktos reikšmės be laiko juostos poslinkio; sent_at gali turėti reikšmę null. Į sąrašą neįtraukiamas žiniatinklio pranešimo būsenos laukas, kurį grąžina atskiras būsenos galinis taškas.

Saugus sąrašo puslapių suderinimas

Vadovaukitės pagination.page, limit, total ir total_pages reikšmėmis. Puslapiai, kurių numeriai didesni už paskutinio puslapio numerį, gali būti tušti. Kol naršote, dėl naujų užduočių įrašai gali persikelti į kitus puslapius. Jungdami puslapius išsaugokite užduočių identifikatorius; šis galinis taškas negarantuoja nekintančios duomenų momentinės kopijos.

Privatumas ir pakartotiniai bandymai

Siunčiamų faksų įrašuose yra privačių telefoninių metaduomenų. Apribokite, kas gali juos skaityti, ir venkite į žurnalus įrašyti visus atsakymus. Jei įrašo sąraše nėra, tai neįrodo, kad siuntimo užklausa nepavyko: prieš pateikdami ją pakartotinai patikrinkite išsaugotą užduoties identifikatorių ir portalo siunčiamų faksų aplanką. Naujas siuntimas gali sukurti dar vieną faksą, už kurį gali būti imamas mokestis. Galutinės foninio vykdytojo veikimo, atsiskaitymo, atgalinių iškvietimų ir duomenų saugojimo garantijos dar peržiūrimos.