SparkTG

توثيق تقرير سجلات المكالمات CDR (الإصدار 2)

تقرير سجلات المكالمات CDR (الإصدار 2)

v2

تقرير سجلات المكالمات CDR (الإصدار 2)

سجلات تفاصيل المكالمات لفترة زمنية محددة

API v2v2نقطة نهاية 1

نظرة عامة

قابل للفوترة: تُحتسب رسوم هذه الواجهة بحسب عدد السجلات المُعادة. يُرجى التواصل مع مدير حسابك لمعرفة تفاصيل التسعير. تُعيد سجلات تفاصيل المكالمات للخدمة والفترة الزمنية. أرسل جسم 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؛ تُخفَّض القيم الأكبر إلى هذا الحد.

سيناريوهات الاستخدام

الوضع العادي

الوضع الافتراضي. تُعاد ring_start_time و start_time و end_time كسلاسل نصية بصيغة yyyy-MM-ddTHH:mm:ss بتوقيت IST.

0 معاملمتاح في الأمثلة

الوضع الموسّع

اضبط mode على extended. يبقى الغلاف وكل حقول الوضع العادي دون تغيير؛ ويحمل كل سجل أيضًا agent_answered و ivr_in_time و ivr_out_time و ivr_duration و queue_in_time و queue_out_time و queue_duration و total_wait_duration.

0 معاملمتاح في الأمثلة

مثال سريع

جرّب هذه الواجهة بأمر cURL بسيط

استدعاء 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 الخاص بك

معاينة الاستجابة

استجابة نموذجية من هذه الواجهة

استجابة نموذجية
{"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...
عرض صيغة الاستجابة الكاملة في قسم الاستجابة