অ্যাকাউন্টের কল রেকর্ড পড়ুন

অ্যাকাউন্টের কল রেকর্ড সংগ্রহ করুন

আপনার 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 থাকতে পারে। ফলাফলের কোড স্ট্রিং হতে পারে। কোনো রেকর্ড না পাওয়া গেলে সফল প্রতিক্রিয়া হিসেবে খালি তালিকা দেওয়ার পরিবর্তে No entries found বার্তাসহ API কোড 404 দেওয়া হয়।

রেকর্ডের ফিল্ড

এন্ডপয়েন্টটি ফলাফলের কোনো সুস্পষ্ট ক্রম বা পৃষ্ঠাভাগ নির্ধারণ করে না। নতুন রেকর্ড আগে আসবে, সারির ক্রম স্থির থাকবে বা ধাপে ধাপে নতুন তথ্য সমন্বয়ের জন্য কার্সর থাকবে—এমন ধরে নেবেন না। ফেরত পাওয়া বিলসংক্রান্ত ফিল্ডগুলো সংরক্ষিত কল রেকর্ডের অংশ, ভবিষ্যতের কোনো কলের মূল্যপ্রস্তাব নয়।

ত্রুটি ও প্রতিবেদন তৈরির সীমাবদ্ধতা

HTTP স্ট্যাটাস এবং JSON-এর status.code/status.msg উভয়ই পড়ুন। নির্বাচিত অ্যাকাউন্ট ও সময়সীমায় কোনো রেকর্ড না থাকলে API কোড 404 ফেরত আসে। প্রমাণীকরণ ও উৎস আইপি ঠিকানার বিধিনিষেধও প্রযোজ্য। পৃষ্ঠায় ভাগ না করা বড় প্রতিবেদন বা অনির্ভরযোগ্য নিজস্ব তারিখের অনুরোধ ব্যর্থ হতে পারে; বারবার সম্পূর্ণ সারণি পড়ে দেখা ধাপে ধাপে নতুন তথ্য রপ্তানির কৌশল নয়।

পর্যালোচিত হ্যান্ডলারে তথ্য পড়ার কোয়েরি রয়েছে; অ্যাকাউন্ট থেকে অর্থ কাটা বা কল শুরু করার কোনো কার্যক্রম নেই। কোনো রেকর্ড ফেরত পাওয়া মানেই কোনো ব্যক্তি কলের উত্তর দিয়েছেন, তার প্রমাণ নয়; আপনার প্রতিবেদনের প্রয়োজন অনুযায়ী সংরক্ষিত কলের পরিণতি ও সময়কালের অর্থ ব্যাখ্যা করুন।