Gauti paskyros skambučių įrašus
Skaitykite savo API paskyros įeinančių arba išeinančių skambučių įrašus. Šiuose įrašuose yra privačios informacijos apie skambučius ir apmokestinimą. Tvarkykite juos tik įgaliotuose serverio pusės procesuose ir be reikalo jų neregistruokite žurnaluose bei nesidalykite jais.
Šis senasis galinis taškas šiuo metu naudoja fiksuotą numatytąjį datų intervalą ir nepalaiko puslapiavimo. Jei reikia kito ataskaitinio laikotarpio arba eksportuoti daug istorinių duomenų, naudokite portalo skambučių istorijos ir eksporto funkcijas; pasirinktiniai šio galinio taško datų parametrai nėra patikimi.
Užklausos
Autentifikuokitės per HTTPS, naudodami įjungtą API paskyrą iš jai leidžiamo šaltinio IP adreso. Pavyzdyje prisijungimo duomenys saugomi aplinkos kintamuosiuose. Palaikomoms numatytojo laikotarpio užklausoms užklausos turinio nereikia.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Kelias | Aprėptis |
|---|---|
| /v3/cdrs | Paskyros įeinančių skambučių įrašai numatytajame datų intervale. |
| /v3/cdrs/{number} | Įeinančių skambučių įrašai, kurių numeris tiksliai sutampa su pateiktu numeriu. Geriausia pateikti visą skaitmenų seką, naudojamą jūsų numerių sąraše. |
| /v3/cdrs/all/outbound | Paskyros išeinančių skambučių įrašai numatytajame datų intervale. Išeinančių skambučių apdorojimo šaka nepaiso pirmojo kelio argumento; all čia yra vietaženklis, o ne visus įeinančius skambučius atitinkantis pakaitos šablonas. |
Naudokite tiksliai tokią krypties reikšmę inbound arba outbound, kokia parodyta pirmiau. Išeinančių skambučių apdorojimo šakoje filtravimas pagal atskirą numerį neįgyvendintas. Pridėjus numerį prie šio kelio, išeinančių skambučių rezultatų imtis nesusiaurėja.
Numatytasis ataskaitinis laikotarpis
Užklausos laikotarpis prasideda vidurnaktį pagal serverio kalendorių tą dieną, kuri buvo prieš 30 dienų, ir baigiasi vidurnaktį šiandienos pradžioje. Todėl likusi dabartinės dienos dalis į jį nepatenka. Tai nėra slenkantis 720 valandų laikotarpis, pasibaigiantis dabartiniu momentu.
Dabartinėje realizacijoje formos laukai date_from/date_to nėra patikimai palaikomi: pateikus pasirinktines datas, duomenų skaidinių metų kintamieji lieka nenustatyti. Nenaudokite šių laukų ataskaitoms gamybinėje aplinkoje. Užklausos eilutėje perduodamos datos ir puslapiavimo parametrai kaip alternatyvos neįgyvendinti.
Atsakymas
Pavyzdyje pateikti tik pasirinkti įeinančių skambučių laukai; duomenys išgalvoti ir tai nėra visas grąžinamas įrašas.
{
"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 yra sąrašas. Bendroje atsakymo struktūroje gali būti laukas status.results, nurodantis eilučių skaičių. Rezultatų kodai gali būti eilutės. Kai įrašų nėra, vietoj sėkmingo atsakymo su tuščiu sąrašu grąžinamas API kodas 404 su pranešimu No entries found.
Įrašo laukai
| Laukai | Reikšmė |
|---|---|
| number, callerid | Įeinančio skambučio numeris ir skambinančiojo identifikatorius įeinančių skambučių laukų rinkinyje. |
| calling, called, callerid | Skambinančiosios ir kviečiamosios pusės identifikatoriai išeinančių skambučių laukų rinkinyje. Nelaikykite skambinančiojo identifikatoriaus patvirtintos abonento tapatybės įrodymu. |
| disposition, billseconds, billcost | Išsaugota skambučio baigtis, apmokestinta trukmė ir išsaugota apmokestinimo suma. Reikšmės gali būti pateiktos senaisiais duomenų bazės eilučių formatais. |
| callsid | Išsaugotas skambučio UUID, skirtas įrašams susieti. |
| date_created | Datos ir laiko eilutė su pažodine priesaga UTC; negarantuojama, kad tai yra ISO8601 formato laiko žyma. Analizuodami eilutę aiškiai nurodykite grąžinamą formatą. |
| Kiti laukai | Įeinančių skambučių įrašuose taip pat yra gedimų, kainos, kanalo, kokybės ir kilmės diagnostinių duomenų; išeinančių skambučių įrašuose yra skambučio užbaigimo regiono diagnostinių duomenų. Visame atsakyme gali būti informacijos apie infrastruktūrą, todėl jis turi būti laikomas privačiu. |
Galinis taškas nenustato aiškios rikiavimo tvarkos ir nepalaiko puslapiavimo. Nemanykite, kad pirmiausia grąžinami naujausi rezultatai, kad eilučių tvarka yra pastovi ar kad yra prieauginiam sinchronizavimui skirtas žymeklis. Grąžinami apmokestinimo laukai yra išsaugoti skambučių duomenys, o ne būsimo skambučio kainos pasiūlymas.
Klaidos ir ataskaitų teikimo apribojimai
Tikrinkite ir HTTP būseną, ir JSON laukus status.code/status.msg. Jei pasirinktoje paskyroje ir laikotarpyje įrašų nėra, grąžinamas API kodas 404. Taip pat taikomas autentifikavimas ir šaltinio IP adreso apribojimai. Didelės ataskaitos be puslapiavimo arba nepatikimos užklausos su pasirinktinėmis datomis vykdymas gali nepavykti; pakartotinis visos lentelės nuskaitymas nėra prieauginio eksporto strategija.
Peržiūrėtame užklausų apdorojimo kode yra skaitymo užklausų, tačiau nėra nei lėšų nurašymo iš paskyros, nei skambučio inicijavimo. Grąžintas įrašas neįrodo, kad atsiliepė žmogus; išsaugotą skambučio baigtį ir trukmę vertinkite pagal savo ataskaitų paskirtį.