Saņemto faksu saraksts

Saņemto faksu saraksts

Izmantojiet aktivizētu MultiTEL API kontu, pieslēdzoties ar HTTPS un ievērojot kontam konfigurētos piekļuves datus un IP ierobežojumus. Šis galapunkts uzskaita autentificētajam kontam piederošos saņemtos faksus. Tas nenosūta faksu un nelejupielādē tā dokumentu.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

Datumu robežas ir iekļaujošas un izmanto API servera datuma interpretāciju, nevis pieprasītu lietotāja laika joslu. Nederīgas datumu virknes var tikt ignorētas, nevis noraidītas; pārbaudiet to derīgumu pirms nosūtīšanas. Ja datumu filtri nav norādīti, pieprasījuma apstrādātājs nepiemēro noklusējuma datumu intervālu. Rezultāti ir sakārtoti pēc saņemšanas laika, sākot ar jaunākajiem. Galapunkts nenodrošina nemainīgu datu momentuzņēmumu visās lapās: jauni saņemtie faksi var pārvietot ierakstus starp lapām.

Pastkastes lapas nolasīšana

Pārbaudiet HTTP rezultātu un JSON lauku status.code. Kļūmēm citviet API var tikt izmantota JSON kļūdas atbildes struktūra arī tad, ja HTTP statuss ir 200. Veiksmīga atbilde satur response.faxes un response.pagination. Šajā piemērā izmantotas izdomātas vērtības.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id ir iesūtnes ieraksta skaitliskais identifikators. hash ir tā MD5 attēlojums mantotajai ienākošo dokumentu darbplūsmai; tas nav send_fax uzdevuma identifikators vai autorizācijas akreditācijas dati. Neizmantojiet to ar izejošo faksu fax_status galapunktu.

received_timestamp ir saglabātais Unix laikspiedols. received_at ir servera formatēts laikspiedols bez laika joslas nobīdes vai null, ja saņemšanas laiks nav reģistrēts; attēlojot laikus savā laika joslā, izmantojiet Unix vērtību. cost ir JSON skaitlis, nevis cenas piedāvājums vai apliecinājums atsevišķi veiktam maksas ieturējumam.

status vērtība ir success tikai tad, ja saglabātais statusa kods ir nulle; citām vērtībām tā kļūst par failed. status_text satur saglabāto apstrādes ziņojumu; ja tā nav, tiek izmantots OK vai Failed. emailed saglabā datubāzē esošo vērtību, nevis pārveido to par loģisko vērtību. viewed ir loģiskā vērtība. Neizdariet secinājumu par veiksmīgu e-pasta piegādi, pamatojoties tikai uz faksa statusu.

Tukšu un mainīgu sarakstu apstrāde

Tukša pastkaste atgriež tukšu faxes masīvu, total ar vērtību 0 un total_pages ar vērtību 0. Arī lapa aiz pēdējās lapas var atgriezt tukšu masīvu. Pārtrauciet lapu nolasīšanu atbilstoši lapošanas laukiem, nevis pieņemot, ka vienmēr ir vismaz viena lapa. Nav pieejams ne kursors, ne sekundārā kārtošana pēc ieraksta identifikatora. Saglabājiet ierakstu identifikatorus, saskaņojot datus no lapām, kuru saturs pārklājas.

Piekļuve dokumentiem un privātums

Pastkastes ieraksti satur privātus tālruņu un dokumentu metadatus. Ierobežojiet piekļuvi savā lietotnē un izvairieties no pilnu atbilžu ierakstīšanas žurnālos. Saraksta iegūšana neatzīmē dokumentu kā skatītu. Izmantojiet fax_file ar iepriekšējo darbplūsmu saderīgai ienākošo dokumentu lejupielādei, ņemot vērā, ka tas atzīmē esošu ienākošā faksa ierakstu kā skatītu pat tad, ja tā fails nav pieejams. Piekļuvei dokumentiem var izmantot arī portāla iesūtni. Failu glabāšanas garantija nav noteikta.