Čitanje zapisa o pozivima za račun

Dohvat zapisa o pozivima za račun

Čitajte zapise o dolaznim ili odlaznim pozivima za svoj API račun. Ti zapisi sadržavaju privatne podatke o pozivima i naplati. Obrađujte ih samo u ovlaštenim tijekovima rada na poslužiteljskoj strani i izbjegavajte nepotrebno zapisivanje u dnevnike ili dijeljenje.

Ova naslijeđena krajnja točka trenutačno ima fiksno zadano razdoblje i nema straničenje. Kada trebate drugo izvještajno razdoblje ili opsežan izvoz povijesnih podataka, upotrijebite tijek rada za povijest poziva i izvoz na portalu; parametri prilagođenih datuma na ovoj krajnjoj točki nisu pouzdani.

Zahtjevi

Autentificirajte se putem protokola HTTPS koristeći svoj omogućeni API račun s njegove dopuštene izvorišne IP adrese. U primjeru se upotrebljavaju vjerodajnice u varijablama okruženja. Za podržane zahtjeve za zadano razdoblje nije potrebno tijelo zahtjeva.

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

Putanje zahtjeva za zapise o pozivima
Putanja	Obuhvat
/v3/cdrs	Zapisi o dolaznim pozivima za račun u zadanom razdoblju.
/v3/cdrs/{number}	Zapisi o dolaznim pozivima čiji broj točno odgovara navedenom broju. Po mogućnosti upotrijebite cijeli niz znamenki iz svoje evidencije brojeva.
/v3/cdrs/all/outbound	Zapisi o odlaznim pozivima za račun u zadanom razdoblju. Grana obrade odlaznih poziva zanemaruje prvi argument putanje; all ovdje je rezervirano mjesto, a ne zamjenski izraz za dolazne pozive.

Upotrijebite točno vrijednost smjera inbound ili outbound prikazanu iznad. Grana obrade odlaznih poziva ne implementira filtar po pojedinom broju. Dodavanje broja toj putanji ne sužava rezultate za odlazne pozive.

Zadano izvještajno razdoblje

Upit počinje u ponoć na kalendarski datum poslužitelja 30 dana prije današnjeg dana, a završava u ponoć na početku današnjeg dana. Zato ne obuhvaća ostatak tekućeg dana. To nije pomično razdoblje od 720 sati koje završava u trenutačnom trenutku.

Trenutačna implementacija ne podržava pouzdano polja obrasca date_from/date_to: pri navođenju prilagođenih datuma njezine varijable za godinu particije ostaju nepostavljene. Nemojte upotrebljavati ta polja za izvješće u produkcijskom okruženju. Datumi u nizu upita i parametri straničenja nisu implementirani kao alternative.

Odgovor

Prikazana su samo odabrana polja za dolazne pozive radi ilustracije; podaci su izmišljeni i ne predstavljaju cijeli vraćeni zapis.

{
  "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 je popis. Zajednička omotnica odgovora može uključivati status.results kao broj redaka. Kodovi rezultata mogu biti znakovni nizovi. Kada nema zapisa, rezultat upotrebljava API kod 404 s porukom No entries found umjesto praznog popisa sa statusom uspjeha.

Polja zapisa

Glavna vraćena polja
Polja	Značenje
number, callerid	Broj dolaznog poziva i identifikator pozivatelja u odabiru polja za dolazne pozive.
calling, called, callerid	Identifikatori pozivatelja i pozvane strane u odabiru polja za odlazne pozive. Nemojte iz identifikacije pozivatelja zaključivati da je identitet pretplatnika provjeren.
disposition, billseconds, billcost	Pohranjeni ishod poziva, obračunato trajanje i pohranjeni iznos naplate. Vrijednosti mogu upotrebljavati naslijeđene formate znakovnih nizova iz baze podataka.
callsid	Pohranjeni UUID poziva za povezivanje povezanih podataka.
date_created	Znakovni niz datuma i vremena s doslovnim sufiksom UTC, a ne zajamčena vremenska oznaka u formatu ISO8601. Izričito parsirajte vraćeni format.
Ostala polja	Zapisi o dolaznim pozivima uključuju i dijagnostičke podatke o pogreškama, troškovima, kanalima, kvaliteti i podrijetlu; zapisi o odlaznim pozivima uključuju dijagnostičke podatke o regiji terminacije poziva. Cijeli odgovor može uključivati podatke o infrastrukturi i treba ga smatrati privatnim.

Krajnja točka ne dodaje izričito sortiranje ni straničenje. Nemojte pretpostavljati da su najnoviji rezultati prvi, da je redoslijed redaka stabilan ili da postoji kursor za inkrementalnu sinkronizaciju. Vraćena polja naplate pripadaju pohranjenim zapisima o pozivima i nisu ponuda cijene za budući poziv.

Pogreške i ograničenja izvješćivanja

Pročitajte i HTTP status i status.code/status.msg u odgovoru JSON. Ako nema zapisa za odabrani račun i razdoblje, vraća se API kod 404. Primjenjuju se i autentifikacija te ograničenja izvorišne IP adrese. Veliko izvješće bez straničenja ili nepouzdan zahtjev s prilagođenim datumima može završiti neuspješno; ponovljeno ispitivanje cijele tablice nije strategija inkrementalnog izvoza.

Pregledani obrađivač zahtjeva sadržava upite za čitanje i ne tereti račun niti pokreće pozive. Vraćeni zapis ne dokazuje da se osoba javila; tumačite pohranjeni ishod i trajanje poziva u skladu sa svrhom svojeg izvješćivanja.