Читање евиденције позива налога

Преузимање евиденције позива налога

Читајте записе о долазним или одлазним позивима за свој API налог. Ови записи садрже приватне податке о позивима и наплати. Обрађујте их само у овлашћеним поступцима на серверу и избегавајте непотребно бележење у дневнике или дељење.

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

Захтеви

Аутентификујте се преко HTTPS користећи свој омогућени API налог са његове дозвољене изворне IP адресе. Пример користи акредитиве из променљивих окружења. За подржане захтеве за подразумевани период није потребно тело захтева.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cdrs

Путање захтева за евиденцију позива
Путања	Обухват
/v3/cdrs	Записи о долазним позивима налога у подразумеваном временском периоду.
/v3/cdrs/{number}	Записи о долазним позивима чији број потпуно одговара наведеном броју. Најбоље је да наведете цео низ цифара који се користи у вашој евиденцији бројева.
/v3/cdrs/all/outbound	Записи о одлазним позивима налога у подразумеваном временском периоду. Грана за одлазне позиве занемарује први аргумент путање; all овде служи као попуна, а не као џокер за долазне позиве.

Користите смер inbound или outbound тачно како је приказано изнад. Грана за одлазне позиве нема филтер по броју. Додавање броја тој путањи не сужава резултате одлазних позива.

Подразумевани извештајни период

Период упита почиње у поноћ на календарски датум сервера који је 30 дана пре данашњег датума и завршава се у поноћ на почетку данашњег дана. Зато не обухвата остатак текућег дана. Ово није помични период од 720 сати који се завршава у тренутку слања упита.

Тренутна имплементација не подржава поуздано поља обрасца date_from/date_to: када се наведу произвољни датуми, променљиве за године партиција остају неподешене. Немојте користити та поља за извештаје у продукционом окружењу. Датуми у упитном делу URL-а и параметри пагинације нису имплементирани као алтернативе.

Одговор

Приказана су само одабрана поља долазних позива ради илустрације; подаци су измишљени и не представљају цео враћени запис.

{
  "status": {
    "code": "200",
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "callerid": "12025550124",
      "disposition": "ANSWERED",
      "billseconds": "60",
      "billcost": "0.0100",
      "callsid": "11111111111111111111111111111111",
      "date_created": "2026-10-01 12:00:00 UTC"
    }
  ]
}

response је листа. Заједнички омотач одговора може да садржи status.results као број редова. Кодови резултата могу бити ниске. Када нема записа, резултат користи код API 404 са поруком No entries found уместо успешног одговора са празном листом.

Поља записа

Главна поља која се враћају
Поља	Значење
number, callerid	Број на који је упућен долазни позив и идентификатор позиваоца у скупу поља за долазне позиве.
calling, called, callerid	Идентификатори позивајуће и позване стране у скупу поља за одлазне позиве. Не закључујте да је идентитет претплатника потврђен на основу идентификације позиваоца.
disposition, billseconds, billcost	Сачувани исход позива, обрачунато трајање и сачувани износ наплате. Вредности могу користити наслеђене формате ниски из базе података.
callsid	Сачувани UUID позива за повезивање повезаних записа.
date_created	Ниска са датумом и временом која садржи дословни суфикс UTC, а није гарантовано временска ознака у формату ISO8601. При рашчлањивању изричито наведите враћени формат.
Остала поља	Записи о долазним позивима садрже и дијагностичке податке о грешкама, трошковима, каналу, квалитету и пореклу; записи о одлазним позивима садрже дијагностичке податке о региону терминације позива. Потпуни одговор може да садржи податке о инфраструктури и треба га третирати као приватан.

Крајња тачка не задаје изричит редослед нити пагинацију. Немојте претпостављати да су најновији резултати први, да је редослед редова стабилан или да постоји курсор за инкременталну синхронизацију. Враћена поља наплате представљају сачувану евиденцију позива, а не понуду цене за будући позив.

Грешке и ограничења извештавања

Проверите и статус HTTP и status.code/status.msg у JSON одговору. Ако нема записа за изабрани налог и период, враћа се код API 404. Важе и ограничења аутентификације и изворне IP адресе. Велики извештај без пагинације или непоуздан захтев са произвољним датумима може да не успе; понављано испитивање целе табеле није стратегија инкременталног извоза.

Прегледани обрађивач садржи упите за читање и не задужује налог нити покреће позиве. Враћени запис не доказује да се особа јавила; тумачите сачувани исход и трајање позива у складу са потребама свог извештавања.