SparkTG

CDR रिपोर्ट (v2) दस्तावेज़ीकरण

CDR रिपोर्ट (v2)

v2

CDR रिपोर्ट (v2)

एक टाइम विंडो के लिए कॉल डिटेल रिकॉर्ड्स

API v2v21 एंडपॉइंट्स

अवलोकन

बिल योग्य: इस API का शुल्क लौटाए गए रिकॉर्ड्स की संख्या के आधार पर लिया जाता है। कीमत की जानकारी के लिए अपने अकाउंट मैनेजर से संपर्क करें। यह सर्विस और टाइम विंडो के लिए कॉल डिटेल रिकॉर्ड्स लौटाता है। JSON बॉडी भेजें (Content-Type: application/json)। हर रिपोर्ट एंडपॉइंट की तरह start_time और end_time अनिवार्य हैं; इनके बिना रिक्वेस्ट 400 लौटाती है। svc_id वैकल्पिक है और डिफ़ॉल्ट रूप से टोकन की सर्विस होती है; अगर आप इसे भेजते हैं, तो टोकन के यूज़र को उस सर्विस के लिए अधिकृत होना चाहिए, वरना रिक्वेस्ट 403 लौटाती है। mode फ़ील्ड normal (डिफ़ॉल्ट, टोटल्स के साथ स्टैंडर्ड CDR सूची) या extended (वही रिकॉर्ड्स, साथ में IVR और क्यू टाइमिंग तथा वेट टाइम) चुनता है। रिक्वेस्ट बॉडी दोनों मोड में एक जैसी होती है। limit अधिकतम 5000 तक सीमित है; इससे ज़्यादा मांगने पर उसे घटाकर 5000 कर दिया जाता है, इसलिए बड़े रिज़ल्ट सेट को पेज करने के लिए offset का उपयोग करें। अज्ञात पैरामीटर अनदेखे कर दिए जाते हैं।

उपलब्ध एंडपॉइंट्स

POST/api/v2/reports/cdr

मुख्य पैरामीटर्स

mode(String)

normal (डिफ़ॉल्ट) या extended।

svc_id(Integer)

जिस सर्विस की रिपोर्ट चाहिए। डिफ़ॉल्ट रूप से टोकन की सर्विस।

start_time(Integer (epoch ms))

विंडो की शुरुआत।

end_time(Integer (epoch ms))

विंडो का अंत (कॉल के स्टार्ट टाइम पर एक्सक्लूसिव)।

offset(Integer)

पेजिनेशन ऑफ़सेट (दोनों मोड में समान)। डिफ़ॉल्ट 0।

limit(Integer)

पेज साइज़। डिफ़ॉल्ट 30। अधिकतम 5000; बड़े मान 5000 तक सीमित कर दिए जाते हैं।

उपयोग परिदृश्य

Normal मोड

डिफ़ॉल्ट। ring_start_time, start_time और end_time IST में yyyy-MM-ddTHH:mm:ss स्ट्रिंग के रूप में लौटाए जाते हैं।

0 पैरामीटर्सउदाहरण सेक्शन में उपलब्ध

Extended मोड

mode को extended सेट करें। एनवलप और normal मोड के सभी फ़ील्ड वैसे ही रहते हैं; हर रिकॉर्ड में अतिरिक्त रूप से agent_answered, ivr_in_time, ivr_out_time, ivr_duration, queue_in_time, queue_out_time, queue_duration और total_wait_duration भी होते हैं।

0 पैरामीटर्सउदाहरण सेक्शन में उपलब्ध

त्वरित उदाहरण

एक साधारण cURL कमांड के साथ इस API को आज़माएं

बेसिक API कॉल
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/cdr' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1775759400000, "end_time": 1776364200000, "offset": 0, "limit": 30, "call_type": "OUTBOUND", "disposition": "ANSWER"}'
💡 <YOUR_TOKEN> की जगह अपना API टोकन डालें

रिस्पॉन्स प्रीव्यू

इस API का सैंपल रिस्पॉन्स

सैंपल रिस्पॉन्स
{"count":268,"data":[{"call_transaction_id":"d341e47a-767a-44fb-8d79-9bf38f4caa28","svc_id":3,"call_type":"OUTBOUND","customer_number":"9634780846","agent_number":"10101","disposition":"Answer","durat...
पूरा रिस्पॉन्स फ़ॉर्मेट देखने के लिए रिस्पॉन्स सेक्शन देखें