SparkTG

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

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

v2

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

الجدول الزمني لتسجيل الدخول والاستراحة، بصف واحد لكل مقطع حالة

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

نظرة عامة

قابل للفوترة: تُحتسب رسوم هذه الواجهة بحسب عدد السجلات المُعادة. يُرجى التواصل مع مدير حسابك لمعرفة تفاصيل التسعير. الجدول الزمني الخام لتسجيل الدخول والاستراحة كتقرير مسطّح، بصف واحد لكل مقطع حالة (معرّف الخدمة، الوكيل، SIP، الوقت، المدة، الحالة). يُستبعد الوكلاء الذين ليس لديهم SIP/امتداد. يجب ألا تتجاوز الفترة يومًا واحدًا، وإلا يُعيد الطلب 400. start_time و end_time في الاستجابة سلاسل نصية بصيغة yyyy-MM-ddTHH:mm:ss بتوقيت IST؛ والمدة بالثواني.

نقاط النهاية المتاحة

POST/api/v2/reports/loginout-raw

المعاملات الرئيسية

svc_id(Integer)

الخدمة المطلوب إعداد التقرير عنها. الافتراضي هو خدمة الرمز المميز.

start_time(Integer (epoch ms))

بداية الفترة.

end_time(Integer (epoch ms))

نهاية الفترة. يجب ألا يتجاوز النطاق يومًا واحدًا، وإلا 400.

agent_sip(String)

التصفية حسب SIP/الامتداد الخاص بالوكيل، أو قائمة مفصولة بفواصل. اتركه فارغًا أو احذفه لجميع الوكلاء.

مثال سريع

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

استدعاء API أساسي
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/loginout-raw' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1776277800000, "end_time": 1776364200000, "agent_sip": ""}'
💡 استبدل <YOUR_TOKEN> برمز API الخاص بك

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

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

استجابة نموذجية
[{"service_id":3,"agent_name":"Ravi Kumar","sip":"1042","start_time":"2026-04-16T00:00:00","end_time":"2026-04-16T01:00:00","duration":3600,"status_code":1,"status_label":"Meal"}]
عرض صيغة الاستجابة الكاملة في قسم الاستجابة