اکاؤنٹ کی کالوں کے ریکارڈ پڑھیں

اکاؤنٹ کی کالوں کے ریکارڈ حاصل کریں

اپنے 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 واپس ملتا ہے۔ توثیق اور ماخذ انٹرنیٹ پتے کی پابندیاں بھی لاگو ہوتی ہیں۔ صفحات میں تقسیم کے بغیر بڑی رپورٹ یا اپنی مقرر کردہ تاریخوں کی غیر قابل اعتماد درخواست ناکام ہو سکتی ہے؛ پورے جدول کو بار بار استفسار کرکے حاصل کرنا مرحلہ وار برآمد کی حکمت عملی نہیں ہے۔

جائزہ لیے گئے درخواست سنبھالنے والے کوڈ میں پڑھنے کے استفسارات ہیں؛ اس میں اکاؤنٹ سے رقم کاٹنے یا کال شروع کرنے کا عمل نہیں ہے۔ واپس ملنے والا ریکارڈ یہ ثابت نہیں کرتا کہ کسی شخص نے کال کا جواب دیا تھا؛ اپنی رپورٹنگ کی ضرورت کے مطابق کال کے انجام کی محفوظ شدہ حالت اور دورانیے کی تشریح کریں۔