Merrni regjistrimet e thirrjeve të llogarisë
Lexoni regjistrimet e thirrjeve hyrëse ose dalëse për llogarinë tuaj API. Këto regjistrime përmbajnë të dhëna private për thirrjet dhe faturimin. Mbajini në rrjedha pune të autorizuara në anën e serverit dhe shmangni ruajtjen në regjistra teknikë ose ndarjen e tyre pa nevojë.
Kjo pikë fundore e vjetër aktualisht ka një interval të parazgjedhur datash të pandryshueshëm dhe nuk ofron ndarje në faqe. Përdorni rrjedhën e punës së portalit për historikun e thirrjeve dhe eksportin kur ju duhet një periudhë tjetër raportimi ose eksporte të mëdha të të dhënave historike; parametrat e datave të personalizuara në këtë pikë fundore nuk janë të besueshëm.
Kërkesat
Autentikohuni përmes HTTPS duke përdorur llogarinë tuaj të aktivizuar API, nga adresa IP burimore e lejuar për të. Shembulli përdor kredenciale në variablat e mjedisit. Kërkesat e mbështetura për intervalin e parazgjedhur nuk kanë nevojë për trup kërkese.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Shtegu | Fusha e mbulimit |
|---|---|
| /v3/cdrs | Regjistrimet e thirrjeve hyrëse të llogarisë brenda intervalit të parazgjedhur të datave. |
| /v3/cdrs/{number} | Regjistrimet e thirrjeve hyrëse, numri i të cilave përputhet saktësisht me numrin e dhënë. Preferoni numrin me të gjitha shifrat, siç përdoret në inventarin tuaj. |
| /v3/cdrs/all/outbound | Regjistrimet e thirrjeve dalëse të llogarisë brenda intervalit të parazgjedhur të datave. Dega për thirrjet dalëse e shpërfill argumentin e parë të shtegut; all këtu është një vlerë që zë vendin e argumentit, jo një shenjë përgjithësuese për thirrjet hyrëse. |
Përdorni saktësisht drejtimin inbound ose outbound të treguar më sipër. Dega për thirrjet dalëse nuk zbaton filtër sipas numrit. Shtimi i një numri në atë shteg nuk i kufizon rezultatet e thirrjeve dalëse.
Intervali i parazgjedhur i raportimit
Kërkimi fillon në mesnatën e datës kalendarike të serverit që është 30 ditë para ditës së sotme dhe përfundon në mesnatë, në fillim të ditës së sotme. Prandaj nuk përfshin pjesën tjetër të ditës aktuale. Ky nuk është një interval lëvizës prej 720 orësh që përfundon në çastin aktual.
Implementimi aktual nuk i mbështet në mënyrë të besueshme fushat e formularit date_from/date_to: dhënia e datave të personalizuara i lë të pacaktuara variablat e tij për vitet e ndarjeve të të dhënave. Mos i përdorni këto fusha për një raport në mjedisin e prodhimit. Datat në vargun e kërkimit dhe parametrat e ndarjes në faqe nuk janë implementuar si alternativa.
Përgjigjja
Paraqiten vetëm disa fusha të përzgjedhura të thirrjeve hyrëse për ilustrim; këto janë të dhëna të sajuara, jo regjistrimi i plotë i kthyer.
{
"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 është një listë. Struktura e përbashkët që mbështjell përgjigjen mund të përfshijë status.results si numrin e rreshtave të saj. Kodet e rezultateve mund të jenë vargje karakteresh. Një rezultat pa regjistrime përdor kodin API 404 me mesazhin No entries found, në vend të një liste të zbrazët të kthyer me sukses.
Fushat e regjistrimeve
| Fushat | Kuptimi |
|---|---|
| number, callerid | Numri hyrës dhe identifikuesi i telefonuesit për projeksionin e thirrjeve hyrëse. |
| calling, called, callerid | Identifikuesit e telefonuesit dhe të marrësit për projeksionin e thirrjeve dalëse. Mos nxirrni përfundimin se identiteti i pajtimtarit është i verifikuar duke u bazuar te identifikuesi i telefonuesit. |
| disposition, billseconds, billcost | Gjendja përfundimtare e ruajtur e thirrjes, kohëzgjatja e faturuar dhe shuma e ruajtur e faturimit. Vlerat mund të përdorin formate të vjetra vargjesh karakteresh të bazës së të dhënave. |
| callsid | Identifikuesi UUID i ruajtur i thirrjes, për lidhjen me të dhëna të tjera përkatëse. |
| date_created | Një varg karakteresh për datën dhe orën me prapashtesën e shkruar fjalë për fjalë UTC, pa garanci se është një vulë kohore ISO8601. Analizojeni shprehimisht sipas formatit të kthyer. |
| Fusha të tjera | Regjistrimet e thirrjeve hyrëse përfshijnë edhe të dhëna diagnostikuese për dështimet, kostot, kanalet, cilësinë dhe origjinën; regjistrimet e thirrjeve dalëse përfshijnë të dhëna diagnostikuese për rajonin e përfundimit të thirrjes. Përgjigjja e plotë mund të përfshijë informacion për infrastrukturën dhe duhet trajtuar si private. |
Pika fundore nuk shton renditje të shprehur ose ndarje në faqe. Mos supozoni se rezultatet shfaqen nga më i riu, se rreshtat kanë rend të qëndrueshëm ose se ka një kursor për sinkronizim me shtesa. Fushat e faturimit të kthyera janë regjistrime të ruajtura të thirrjeve, jo një ofertë çmimi për një thirrje të ardhshme.
Gabimet dhe kufizimet e raportimit
Lexoni si statusin HTTP, ashtu edhe status.code/status.msg në JSON. Mungesa e regjistrimeve në llogarinë dhe intervalin e zgjedhur kthen kodin API 404. Zbatohen gjithashtu autentikimi dhe kufizimet për adresën IP burimore. Një raport i madh pa ndarje në faqe ose një kërkesë me data të personalizuara që nuk funksionon në mënyrë të besueshme mund të dështojë; kërkimi i përsëritur në të gjithë tabelën nuk është një strategji eksporti me shtesa.
Trajtuesi i shqyrtuar përmban kërkime për lexim dhe nuk debiton llogarinë apo nis thirrje. Një regjistrim i kthyer nuk provon se është përgjigjur një person; interpretoni gjendjen përfundimtare dhe kohëzgjatjen e ruajtur sipas rastit tuaj të përdorimit për raportim.