Листа примљених факсова

Листа примљених факсова

Користите активиран MultiTEL API налог преко протокола HTTPS, са подешеним приступним подацима и ограничењима IP адреса. Ова крајња тачка приказује листу примљених факсова који припадају аутентификованом налогу. Она не шаље факс нити преузима његов документ.

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

Границе датума су укључене и тумаче се према правилима сервера API, а не према затраженој временској зони корисника. Неисправни низови знакова за датуме могу бити занемарени уместо одбијени; проверите њихову исправност пре слања. Када нема филтера по датуму, обрађивач не намеће подразумевани временски период. Резултати су поређани по времену пријема, од најновијих. Крајња тачка не обезбеђује непроменљив пресек података кроз странице: новопримљени факсови могу померити записе са једне странице на другу.

Прочитајте страницу пријемног сандучета

Прочитајте резултат HTTP и, у одговору у формату JSON, поље status.code. Грешке у другим деловима API могу бити враћене у омотачу грешке у формату JSON чак и када је статус HTTP 200. Успешан одговор садржи response.faxes и response.pagination. У овом примеру користе се измишљене вредности.

{
  "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 је нумерички идентификатор записа у пријемном сандучету. hash је његов MD5 приказ за старији ток рада са примљеним документима; није идентификатор задатка send_fax нити податак за ауторизацију. Не користите га са крајњом тачком за одлазне факсове fax_status.

received_timestamp је сачувана Unix временска ознака. received_at је временска ознака коју форматира сервер, без помераја временске зоне, или null ако време пријема није забележено; користите Unix вредност када приказујете времена у својој временској зони. cost је број у формату JSON, а не понуда цене нити доказ о засебној извршеној наплати.

status има вредност success само када је сачувани код статуса нула; остале вредности постају failed. status_text садржи сачувану поруку о обради, уз резервне вредности OK или Failed. emailed задржава сачувану вредност уместо логичке вредности. viewed је логичка вредност. Не закључујте да је испорука е-поште била успешна само на основу статуса факса.

Обрадите празне листе и листе које се мењају

Празно пријемно сандуче враћа празан низ faxes, total 0 и total_pages 0. Страница иза последње странице такође може вратити празан низ. Зауставите се према пољима пагинације, уместо да претпостављате да постоји бар једна страница. Нису доступни курсор нити додатно сортирање по идентификатору записа. Сачувајте идентификаторе записа када усклађујете странице чији се садржај преклапа.

Приступ документима и приватност

Записи у пријемном сандучету садрже приватне метаподатке о телефонским бројевима и документима. Ограничите приступ у својој апликацији и избегавајте бележење потпуних одговора у евиденције. Приказивање листе не означава документ као прегледан. Користите fax_file за преузимање примљених докумената ради компатибилности, имајући у виду да се тиме постојећи запис о примљеном факсу означава као прегледан чак и ако његова датотека није доступна. Документима се може приступити и преко пријемног сандучета на порталу. Није утврђена гаранција чувања датотека.