खाते के कॉल रिकॉर्ड पढ़ें

खाते के कॉल रिकॉर्ड प्राप्त करें

अपने API खाते की आने वाली या जाने वाली कॉल के रिकॉर्ड पढ़ें। इन रिकॉर्ड में कॉल और बिलिंग की निजी जानकारी होती है। इन्हें अधिकृत सर्वर-साइड कार्यप्रवाहों में रखें और अनावश्यक रूप से लॉग में दर्ज करने या साझा करने से बचें।

इस पुराने एंडपॉइंट में फ़िलहाल एक निश्चित डिफ़ॉल्ट तारीख अवधि है और पृष्ठांकन नहीं है। जब आपको किसी अन्य अवधि की रिपोर्ट या पुराने रिकॉर्ड का बड़े पैमाने पर निर्यात चाहिए, तो पोर्टल के कॉल इतिहास/निर्यात कार्यप्रवाह का उपयोग करें; इस एंडपॉइंट के कस्टम तारीख पैरामीटर भरोसेमंद नहीं हैं।

अनुरोध

अपने सक्षम API खाते का उपयोग करके उसके अनुमत स्रोत आईपी पते से HTTPS के माध्यम से प्रमाणीकरण करें। उदाहरण में क्रेडेंशियल पर्यावरण चरों में रखे गए हैं। समर्थित डिफ़ॉल्ट अवधि के अनुरोधों में अनुरोध बॉडी की आवश्यकता नहीं है।

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

ऊपर दिखाए गए दिशा मान inbound या outbound का हूबहू उपयोग करें। जाने वाली कॉल की शाखा में नंबर के आधार पर फ़िल्टर लागू नहीं है। उस पाथ में नंबर जोड़ने से जाने वाली कॉल के परिणाम सीमित नहीं होते।

रिपोर्टिंग की डिफ़ॉल्ट अवधि

क्वेरी सर्वर के कैलेंडर के अनुसार आज से 30 दिन पहले की तारीख की शुरुआत वाली मध्यरात्रि से शुरू होती है और आज की शुरुआत वाली मध्यरात्रि पर समाप्त होती है। इसलिए इसमें आज के दिन का बाकी हिस्सा शामिल नहीं होता। यह वर्तमान समय पर समाप्त होने वाली लगातार खिसकती 720 घंटे की अवधि नहीं है।

वर्तमान कार्यान्वयन में date_from/date_to फ़ॉर्म फ़ील्ड का समर्थन भरोसेमंद नहीं है: कस्टम तारीखें देने पर उसके पार्टिशन-वर्ष संबंधी चर सेट नहीं होते। प्रोडक्शन रिपोर्ट के लिए इन फ़ील्ड का उपयोग न करें। विकल्प के रूप में क्वेरी स्ट्रिंग की तारीखें और पृष्ठांकन पैरामीटर भी लागू नहीं किए गए हैं।

प्रतिक्रिया

उदाहरण के लिए आने वाली कॉल के केवल कुछ चुने हुए फ़ील्ड दिखाए गए हैं; यह काल्पनिक डेटा है, लौटाया गया पूरा रिकॉर्ड नहीं।

{
  "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 एक सूची है। साझा प्रतिक्रिया आवरण में पंक्तियों की संख्या के रूप में status.results शामिल हो सकता है। परिणाम कोड स्ट्रिंग हो सकते हैं। कोई रिकॉर्ड न मिलने पर सफल खाली सूची के बजाय API कोड 404 और No entries found संदेश वाला परिणाम मिलता है।

रिकॉर्ड के फ़ील्ड

यह एंडपॉइंट कोई स्पष्ट क्रम या पृष्ठांकन नहीं जोड़ता। यह न मानें कि सबसे नए परिणाम पहले आएँगे, पंक्तियों का क्रम स्थिर रहेगा या क्रमिक सिंक्रनाइज़ेशन के लिए कोई कर्सर मिलेगा। लौटाए गए बिलिंग फ़ील्ड संग्रहीत कॉल रिकॉर्ड हैं, भविष्य की किसी कॉल के लिए मूल्य-प्रस्ताव नहीं।

त्रुटियाँ और रिपोर्टिंग की सीमाएँ

HTTP स्थिति और JSON के status.code/status.msg, दोनों को पढ़ें। चुने गए खाते और अवधि में कोई प्रविष्टि न होने पर API कोड 404 लौटता है। प्रमाणीकरण और स्रोत आईपी संबंधी प्रतिबंध भी लागू होते हैं। बिना पृष्ठांकन वाली बड़ी रिपोर्ट या अविश्वसनीय कस्टम तारीख वाला अनुरोध विफल हो सकता है; पूरी तालिका को बार-बार पढ़ना क्रमिक निर्यात की रणनीति नहीं है।

जिस हैंडलर की समीक्षा की गई है, उसमें पढ़ने वाली क्वेरी हैं; खाते से राशि काटने या कॉल शुरू करने की कोई कार्रवाई नहीं है। लौटाया गया रिकॉर्ड यह साबित नहीं करता कि किसी व्यक्ति ने कॉल का उत्तर दिया था; अपनी रिपोर्टिंग की आवश्यकता के अनुसार संग्रहीत कॉल परिणाम और अवधि का अर्थ समझें।