Hae tilin puhelutietueet
Lue API-tilisi saapuvien tai lähtevien puhelujen tietueet. Tietueet sisältävät yksityisiä puhelu- ja laskutustietoja. Käsittele niitä vain valtuutetuissa palvelinpuolen työnkuluissa ja vältä tarpeetonta lokiin kirjaamista tai jakamista.
Tällä vanhalla rajapintapisteellä on tällä hetkellä kiinteä oletusaikaväli, eikä siinä ole sivutusta. Käytä portaalin puheluhistorian ja viennin työnkulkua, kun tarvitset toisen raportointijakson tai suuria historiatietojen vientejä; omat päivämääräparametrit eivät toimi tässä rajapintapisteessä luotettavasti.
Pyynnöt
Todenna itsesi HTTPS-yhteyden kautta käytössä olevalla API-tililläsi sille sallitusta lähde-IP-osoitteesta. Esimerkissä tunnistetiedot ovat ympäristömuuttujissa. Tuetut oletusaikavälin pyynnöt eivät tarvitse pyyntörunkoa.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Polku | Kattavuus |
|---|---|
| /v3/cdrs | Tilin saapuvien puhelujen tietueet oletusaikaväliltä. |
| /v3/cdrs/{number} | Saapuvien puhelujen tietueet, joiden numero vastaa täsmälleen annettua numeroa. Käytä mieluiten numerovarannossasi käytettyä koko numerosarjaa. |
| /v3/cdrs/all/outbound | Tilin lähtevien puhelujen tietueet oletusaikaväliltä. Lähtevien puhelujen käsittelyhaara ohittaa ensimmäisen polkuargumentin; all on tässä paikkamerkki, ei saapuvien puhelujen yleismerkki. |
Käytä yllä esitettyä suuntaa inbound tai outbound täsmälleen annetussa muodossa. Lähtevien puhelujen käsittelyhaarassa ei ole numerokohtaista suodatinta. Numeron lisääminen kyseiseen polkuun ei rajaa lähtevien puhelujen tuloksia.
Raportoinnin oletusaikaväli
Kyselyn aikaväli alkaa keskiyöllä sen palvelimen kalenteripäivän alussa, joka oli 30 päivää ennen tätä päivää, ja päättyy keskiyöllä tämän päivän alussa. Siksi tämän päivän loppuosa ei sisälly siihen. Kyseessä ei ole nykyhetkeen päättyvä liukuva 720 tunnin aikaväli.
Nykyinen toteutus ei tue luotettavasti lomakekenttiä date_from/date_to: omien päivämäärien antaminen jättää sen osiointivuosimuuttujat asettamatta. Älä käytä näitä kenttiä tuotantoraportissa. Kyselymerkkijonon päivämääriä ja sivutusparametreja ei ole toteutettu vaihtoehdoiksi.
Vastaus
Havainnollistava esimerkki sisältää vain valittuja saapuvien puhelujen kenttiä; tiedot ovat kuvitteellisia eivätkä muodosta koko palautettua tietuetta.
{
"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 lista. Yhteinen vastauksen ulkorakenne voi sisältää rivimäärän kentässä status.results. Tuloskoodit voivat olla merkkijonoja. Jos tietueita ei ole, tuloksena on API-koodi 404 ja viesti No entries found onnistumista ilmaisevan tyhjän listan sijaan.
Tietueiden kentät
| Kentät | Merkitys |
|---|---|
| number, callerid | Saapuvan puhelun numero ja soittajan tunniste saapuvien puhelujen kenttävalinnassa. |
| calling, called, callerid | Soittavan ja vastaanottavan osapuolen tunnisteet lähtevien puhelujen kenttävalinnassa. Älä päättele soittajatunnisteen perusteella, että tilaajan henkilöllisyys on varmennettu. |
| disposition, billseconds, billcost | Tallennettu puhelun lopputila, laskutettu kesto ja tallennettu laskutussumma. Arvot voivat käyttää tietokannan vanhoja merkkijonomuotoja. |
| callsid | Puhelun tallennettu UUID tietojen yhdistämistä varten. |
| date_created | Päivämäärän ja kellonajan sisältävä merkkijono, jonka lopussa on kirjaimellisesti UTC; sen ei taata olevan ISO8601-aikaleima. Jäsennä palautettu muoto nimenomaisesti. |
| Muut kentät | Saapuvien puhelujen tietueet sisältävät myös virheisiin, kustannuksiin, kanavaan, laatuun ja alkuperään liittyviä diagnostiikkatietoja; lähtevien puhelujen tietueet sisältävät puhelun terminointialueen diagnostiikkatietoja. Koko vastaus voi sisältää infrastruktuuritietoja, ja sitä on käsiteltävä yksityisenä tietona. |
Rajapintapiste ei lisää nimenomaista järjestystä eikä sivutusta. Älä oleta, että uusimmat tulokset ovat ensin, että rivijärjestys pysyy samana tai että käytettävissä on inkrementaalisen synkronoinnin kohdistin. Palautetut laskutuskentät ovat tallennettuja puhelutietoja, eivät tulevan puhelun hintatarjous.
Virheet ja raportoinnin rajoitukset
Lue sekä HTTP-tilakoodi että JSON-vastauksen status.code/status.msg. Jos valitulla tilillä ei ole tietueita valitulla aikavälillä, palautetaan API-koodi 404. Myös todennusvaatimukset ja lähde-IP-osoitteen rajoitukset ovat voimassa. Suuri sivuttamaton raportti tai epäluotettava omia päivämääriä käyttävä pyyntö voi epäonnistua; koko taulun toistuva kysely ei ole inkrementaalisen viennin strategia.
Tarkastettu käsittelijä sisältää lukukyselyjä, eikä se veloita tiliä tai käynnistä puheluja. Palautettu tietue ei todista, että ihminen vastasi; tulkitse tallennettu lopputila ja kesto raportointitarpeesi mukaan.