Konto kõnekirjete hankimine
Lugege oma API konto sissetulevate või väljaminevate kõnede kirjeid. Need kirjed sisaldavad privaatset kõne- ja arveldusteavet. Hoidke neid volitatud serveripoolsetes töövoogudes ning vältige tarbetut logimist või jagamist.
Sellel pärandliidesel on praegu fikseeritud vaikeperiood ja puudub lehekülgedeks jaotamine. Kui vajate teistsugust aruandeperioodi või mahukaid ajalooliste andmete eksporte, kasutage portaali kõneajaloo ja eksportimise töövoogu; selle lõpp-punkti kohandatud kuupäevaparameetrid ei ole töökindlad.
Päringud
Autentige end protokolli HTTPS kaudu oma aktiveeritud API kontoga sellele kontole lubatud lähte-IP-aadressilt. Näites kasutatakse keskkonnamuutujates olevaid autentimisandmeid. Toetatud vaikeperioodi päringud ei vaja päringukeha.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Tee | Ulatus |
|---|---|
| /v3/cdrs | Konto sissetulevate kõnede kirjed vaikeperioodil. |
| /v3/cdrs/{number} | Sissetulevate kõnede kirjed, mille number vastab täpselt antud numbrile. Eelistage oma numbriloendis kasutatavat täielikku numbrijada. |
| /v3/cdrs/all/outbound | Konto väljaminevate kõnede kirjed vaikeperioodil. Väljaminevate kõnede töötlusharu eirab tee esimest argumenti; all on siin kohatäitja, mitte sissetulevate kõnede metamärk. |
Kasutage täpselt eespool näidatud suunaväärtust inbound või outbound. Väljaminevate kõnede töötlusharus puudub numbripõhine filter. Numbriga selle tee täiendamine ei kitsenda väljaminevate kõnede tulemusi.
Aruandluse vaikeperiood
Päringu periood algab keskööl serveri kalendripäeval, mis on tänasest 30 päeva varasem, ja lõpeb keskööl tänase päeva alguses. Seega ei hõlma see käesoleva päeva ülejäänud osa. See ei ole praegusel hetkel lõppev libisev 720 tunni pikkune ajavahemik.
Praegune teostus ei toeta vormivälju date_from/date_to töökindlalt: kohandatud kuupäevade andmisel jäävad selle partitsiooni aasta muutujad määramata. Ärge kasutage neid välju tootmiskeskkonna aruannetes. Alternatiividena ei ole teostatud päringustringi kuupäevi ega lehekülgedeks jaotamise parameetreid.
Vastus
Näidatud on ainult valitud sissetulevate kõnede väljad; need on väljamõeldud andmed, mitte täielik tagastatav kirje.
{
"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 on loend. Ühine vastuse ümbris võib sisaldada välja status.results, mis näitab ridade arvu. Tulemuskoodid võivad olla stringid. Kirjete puudumisel tagastatakse eduka tühja loendi asemel API kood 404 koos teatega No entries found.
Kirje väljad
| Väljad | Tähendus |
|---|---|
| number, callerid | Sissetuleva kõne number ja helistaja tunnus sissetulevate kõnede valitavate väljade koosseisus. |
| calling, called, callerid | Helistaja ja kõne vastuvõtja tunnused väljaminevate kõnede valitavate väljade koosseisus. Ärge järeldage helistaja tunnuse põhjal, et abonendi isikusamasus on kontrollitud. |
| disposition, billseconds, billcost | Salvestatud kõne tulemus, arveldatud kestus ja salvestatud arveldussumma. Väärtused võivad kasutada pärandandmebaasi stringivorminguid. |
| callsid | Salvestatud kõne UUID seotud andmete seostamiseks. |
| date_created | Kuupäeva ja kellaaja string sõnasõnalise järelliitega UTC; ISO8601 ajatempel ei ole tagatud. Määrake parsimisel tagastatud vorming selgesõnaliselt. |
| Muud väljad | Sissetulevate kõnede kirjed sisaldavad ka tõrgete, maksumuse, kanali, kvaliteedi ja päritolu diagnostikaandmeid; väljaminevate kõnede kirjed sisaldavad kõne termineerimise piirkonna diagnostikaandmeid. Täielik vastus võib sisaldada taristuteavet ja seda tuleb käsitleda privaatsena. |
Lõpp-punkt ei lisa selgesõnalist järjestust ega lehekülgedeks jaotamist. Ärge eeldage, et uusimad tulemused on esimesed, ridade järjestus on püsiv või saadaval on järkjärgulise sünkroonimise kursor. Tagastatud arveldusväljad on salvestatud kõneandmed, mitte tulevase kõne hinnapakkumine.
Vead ja aruandluse piirangud
Kontrollige nii HTTP olekut kui ka JSON välju status.code/status.msg. Kui valitud kontol valitud ajavahemikus kirjeid pole, tagastatakse API kood 404. Kehtivad ka autentimise ja lähte-IP-aadressi piirangud. Mahukas lehekülgedeks jaotamata aruanne või ebatöökindel kohandatud kuupäevadega päring võib ebaõnnestuda; kogu tabeli korduv pärimine ei ole järkjärgulise eksportimise strateegia.
Ülevaadatud töötleja sisaldab lugemispäringuid ega debiteeri kontot ega algata kõnesid. Tagastatud kirje ei tõenda, et kõnele vastas inimene; tõlgendage salvestatud kõne tulemust ja kestust oma aruandlusvajaduse kohaselt.