Iegūt konta zvanu ierakstus
Lasiet sava API konta ienākošo vai izejošo zvanu ierakstus. Šajos ierakstos ir privāta informācija par zvaniem un norēķiniem. Apstrādājiet tos tikai autorizētās servera puses darbplūsmās un izvairieties no nevajadzīgas reģistrēšanas žurnālos vai kopīgošanas.
Šim mantotajam galapunktam pašlaik ir fiksēts noklusējuma datumu periods, un tas neatbalsta dalījumu lapās. Ja nepieciešams cits pārskata periods vai liela apjoma vēsturisko datu eksports, izmantojiet portāla zvanu vēstures un eksportēšanas darbplūsmu; šī galapunkta pielāgoto datumu parametri nav uzticami.
Pieprasījumi
Autentificējieties, izmantojot HTTPS un savu iespējoto API kontu, no šim kontam atļautās avota IP adreses. Piemērā akreditācijas dati tiek ņemti no vides mainīgajiem. Atbalstītajiem noklusējuma perioda pieprasījumiem pamatteksts nav nepieciešams.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Ceļš | Tvērums |
|---|---|
| /v3/cdrs | Konta ienākošo zvanu ieraksti noklusējuma datumu periodā. |
| /v3/cdrs/{number} | Ienākošo zvanu ieraksti, kuru numurs precīzi atbilst norādītajam numuram. Vēlams izmantot pilnu ciparu virkni, kas lietota jūsu numuru uzskaitē. |
| /v3/cdrs/all/outbound | Konta izejošo zvanu ieraksti noklusējuma datumu periodā. Izejošo zvanu apstrādes atzars ignorē pirmo ceļa argumentu; all šeit ir vietturis, nevis ienākošo zvanu aizstājējzīme. |
Izmantojiet tieši iepriekš norādīto virziena vērtību inbound vai outbound. Izejošo zvanu apstrādes atzars neīsteno filtrēšanu pēc atsevišķa numura. Numura pievienošana šim ceļam nesašaurina izejošo zvanu rezultātus.
Noklusējuma pārskata periods
Vaicājuma periods sākas pusnaktī servera kalendārajā datumā 30 dienas pirms šodienas un beidzas pusnaktī šodienas sākumā. Tādēļ tas neietver atlikušo šīs dienas daļu. Tas nav slīdošs 720 stundu periods, kas beidzas pašreizējā brīdī.
Pašreizējā realizācija nenodrošina uzticamu veidlapas lauku date_from/date_to atbalstu: norādot pielāgotus datumus, tās nodalījumu gada mainīgie paliek neiestatīti. Neizmantojiet šos laukus produkcijas vides pārskatiem. Datumi vaicājuma virknē un dalījuma lapās parametri nav ieviesti kā alternatīvas.
Atbilde
Ilustrācijai parādīti tikai daži ienākošo zvanu lauki; šie dati ir izdomāti un nav pilns atgrieztais ieraksts.
{
"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 ir saraksts. Kopējā atbildes ietvarā rindu skaits var būt norādīts laukā status.results. Rezultātu kodi var būt virknes. Ja ierakstu nav, veiksmīgas atbildes ar tukšu sarakstu vietā tiek atgriezts API kods 404 ar ziņojumu No entries found.
Ieraksta lauki
| Lauki | Nozīme |
|---|---|
| number, callerid | Ienākošā zvana numurs un zvanītāja identifikators ienākošo zvanu atlasīto lauku kopā. |
| calling, called, callerid | Zvanītāja un izsauktā saņēmēja identifikatori izejošo zvanu atlasīto lauku kopā. Neuzskatiet zvanītāja identifikatoru par apliecinājumu pārbaudītai abonenta identitātei. |
| disposition, billseconds, billcost | Saglabātais zvana iznākums, tarificētais ilgums un saglabātā norēķinu summa. Vērtībām var būt izmantoti mantoti datubāzes virkņu formāti. |
| callsid | Saglabātais zvana UUID saistīto datu sasaistīšanai. |
| date_created | Datuma un laika virkne ar burtisku UTC sufiksu; netiek garantēts ISO8601 laikspiedols. Parsējot skaidri norādiet atgrieztās virknes formātu. |
| Citi lauki | Ienākošo zvanu ieraksti ietver arī kļūmju, izmaksu, kanāla, kvalitātes un izcelsmes diagnostikas datus; izejošo zvanu ieraksti ietver zvana terminācijas reģiona diagnostikas datus. Pilnajā atbildē var būt informācija par infrastruktūru, un tā jāuzskata par privātu. |
Galapunkts nenodrošina skaidri noteiktu kārtošanu vai dalījumu lapās. Nepieņemiet, ka jaunākie rezultāti ir pirmie, ka rindu secība ir nemainīga vai ka ir pieejams inkrementālās sinhronizācijas kursors. Atgrieztie norēķinu lauki ir saglabāti zvanu dati, nevis nākotnes zvana cenas piedāvājums.
Kļūdas un pārskatu ierobežojumi
Pārbaudiet gan HTTP statusu, gan JSON laukus status.code/status.msg. Ja atlasītajam kontam izvēlētajā periodā nav ierakstu, tiek atgriezts API kods 404. Ir spēkā arī autentifikācijas un avota IP adreses ierobežojumi. Liela apjoma pārskata pieprasījums bez dalījuma lapās vai neuzticams pieprasījums ar pielāgotiem datumiem var neizdoties; atkārtota visas tabulas nolasīšana nav inkrementālas eksportēšanas stratēģija.
Pārskatītajā apstrādātājā ir lasīšanas vaicājumi, un tas neveic līdzekļu norakstīšanu no konta vai zvana sākšanu. Atgriezts ieraksts nepierāda, ka atbildējis cilvēks; interpretējiet saglabāto zvana iznākumu un ilgumu atbilstoši sava pārskata vajadzībām.