Приказ послова слања факсова

Приказ послова слања факсова

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

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

Овај обрађивач не подржава филтере date_from нити date_to. Списак одлазних факсова на порталу има додатне филтере које не треба преносити у овај API захтев. Резултати су поређани по времену креирања, од најновијих, без додатног сортирања по идентификатору или курсора за снимак стања.

Преглед записа о пословима

Проверите и HTTP резултат и поље status.code у JSON одговору. Успешан одговор садржи response.faxes и response.pagination; пример користи измишљене податке. За празно сандуче враћа се празан низ faxes, уз total 0 и 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 је нумерички идентификатор записа. uuid је видљиви идентификатор посла; за нова слања користите идентификатор посла који враћа send_fax и сачувајте га за периодично проверавање статуса. Списак може да садржи старије записе, па немојте претпостављати да је сваки ред креиран преко исте крајње тачке за слање.

status и result_text садрже забележено стање обраде и поруку. Овај приказ их не своди на потпун скуп набројаних стања испоруке. Статус „у реду за обраду“ значи да факс чека у реду, а не да је испоручен. За важне документе потврдите пријем са примаоцем пре него што факс сматрате испорученим или пошаљете дупликат.

pages_requested и pages_sent су бројчане вредности које означавају број страница. cost задржава сачувану вредност, уз резервну вредност 0.00 у облику текстуалног низа; немојте претпостављати да има исти JSON тип као трошак у долазном сандучету. Запис који чека у реду већ може да садржи процену трошка. Ни та вредност ни ставка на списку не потврђују коначан обрачун.

created_at, sent_at и updated_at су сачуване вредности у формату сервера, без одступања временске зоне; sent_at може да има вредност null. Списак не садржи поље статуса вебхука које враћа засебна крајња тачка за статус.

Безбедно усклађивање страница резултата

Пратите pagination.page, limit, total и total_pages. Странице после последње могу бити празне. Нови послови могу померити ставке са једне странице на другу док прегледате резултате. При спајању страница сачувајте идентификаторе послова; ова крајња тачка не гарантује непроменљив снимак стања.

Приватност и поновни покушаји

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