A fiók hívásrekordjainak lekérése

Kérje le API-fiókja bejövő vagy kimenő hívásrekordjait. Ezek a rekordok bizalmas hívási és számlázási adatokat tartalmaznak. Kizárólag jogosult szerveroldali munkafolyamatokban kezelje őket, és kerülje a szükségtelen naplózást vagy megosztást.

Ez a régi végpont jelenleg rögzített alapértelmezett időszakot használ, és nem támogatja a lapozást. Ha más jelentési időszakra vagy nagy mennyiségű korábbi adat exportálására van szüksége, használja a portál híváselőzmény- és exportálási munkafolyamatát; a végpont egyéni dátumparaméterei nem megbízhatók.

Kérések

Végezze el a hitelesítést HTTPS kapcsolaton, engedélyezett API-fiókjával, a fiókhoz engedélyezett forrás-IP-címről. A példa környezeti változókban tárolt hitelesítő adatokat használ. A támogatott, alapértelmezett időszakra vonatkozó kérésekhez nem szükséges kéréstörzs.

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

A hívásrekord-lekérések útvonalai
Útvonal	Hatókör
/v3/cdrs	A fiók bejövő hívásrekordjai az alapértelmezett időszakban.
/v3/cdrs/{number}	Azok a bejövő hívásrekordok, amelyek száma pontosan megegyezik a megadott számmal. Lehetőleg a számnyilvántartásában szereplő teljes számsort használja.
/v3/cdrs/all/outbound	A fiók kimenő hívásrekordjai az alapértelmezett időszakban. A kimenő hívásokat kezelő ág figyelmen kívül hagyja az útvonal első argumentumát; az all itt helykitöltő, nem a bejövő hívások helyettesítő mintája.

Pontosan a fent látható inbound vagy outbound irányértéket használja. A kimenő hívásokat kezelő ág nem valósít meg számonkénti szűrést. Ha számot ad ehhez az útvonalhoz, az nem szűkíti a kimenő hívások találatait.

Alapértelmezett jelentési időszak

A lekérdezés a szerver naptára szerinti, a mai napot 30 nappal megelőző nap kezdetén, éjfélkor indul, és a mai nap kezdetén, éjfélkor ér véget. Ezért a mai nap további részét nem tartalmazza. Ez nem az aktuális időpontban végződő, gördülő 720 órás időszak.

A jelenlegi megvalósítás nem támogatja megbízhatóan a date_from/date_to űrlapmezőket: egyéni dátumok megadásakor a partíció évét meghatározó változók beállítatlanul maradnak. Éles jelentéshez ne használja ezeket a mezőket. Alternatívaként sem valósították meg a lekérdezési karakterláncban megadott dátumok és a lapozási paraméterek kezelését.

Válasz

Csak néhány kiválasztott bejövő mező szemléltetése; az adatok kitaláltak, és nem a teljes visszaadott rekordot mutatják.

{
  "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"
    }
  ]
}

A response egy lista. A közös válaszburkoló a status.results mezőben tartalmazhatja a sorok számát. Az eredménykódok karakterláncok is lehetnek. Ha nincsenek rekordok, az eredmény sikeres üres lista helyett 404 API-kódot és No entries found üzenetet ad.

A rekord mezői

A visszaadott főbb mezők
Mezők	Jelentés
number, callerid	A bejövő hívásokhoz kiválasztott mezők között szereplő bejövő szám és hívóazonosító.
calling, called, callerid	A kimenő hívásokhoz kiválasztott mezők között szereplő hívó- és hívottfél-azonosítók. A hívóazonosítóból ne következtessen ellenőrzött előfizetői személyazonosságra.
disposition, billseconds, billcost	A hívás tárolt kimenetele, a számlázott időtartam és a tárolt számlázási összeg. Az értékek régi adatbázis-karakterláncformátumokat is használhatnak.
callsid	A hívás tárolt UUID-azonosítója az összerendeléshez.
date_created	Dátumot és időt tartalmazó karakterlánc szó szerinti UTC utótaggal; nem garantált, hogy ISO8601 formátumú időbélyeg. A feldolgozás során kifejezetten a visszaadott formátumot értelmezze.
Egyéb mezők	A bejövő rekordok hibákra, költségekre, csatornákra, minőségre és eredetre vonatkozó diagnosztikai adatokat is tartalmaznak; a kimenő rekordokban a hívásvégződtetési régió diagnosztikai adatai szerepelnek. A teljes válasz infrastruktúrára vonatkozó információkat is tartalmazhat, ezért bizalmasan kell kezelni.

A végpont nem alkalmaz kifejezett rendezést vagy lapozást. Ne feltételezze, hogy a legújabb találatok kerülnek előre, hogy a sorok sorrendje állandó, vagy hogy rendelkezésre áll növekményes szinkronizálási kurzor. A visszaadott számlázási mezők tárolt hívásrekordok adatai, nem pedig egy jövőbeli hívásra vonatkozó árajánlat.

Hibák és jelentéskészítési korlátok

Ellenőrizze mind a HTTP-állapotot, mind a JSON válasz status.code/status.msg mezőit. Ha a kiválasztott fiókban és időszakban nincs bejegyzés, a válasz 404 API-kódot ad. A hitelesítési és forrás-IP-címre vonatkozó korlátozások szintén érvényesek. Egy nagy, lapozás nélküli jelentés vagy egy megbízhatatlan egyéni dátumos kérés sikertelen lehet; a teljes tábla ismételt lekérdezése nem növekményes exportálási stratégia.

Az ellenőrzött kezelő olvasási lekérdezéseket tartalmaz, és nem terheli meg a fiókot, illetve nem kezdeményez hívást. Egy visszaadott rekord nem bizonyítja, hogy egy személy fogadta a hívást; a tárolt kimenetelt és időtartamot a jelentéskészítési céljának megfelelően értelmezze.