নম্বর পোর্টিং প্রকল্পের ইভেন্ট পড়ুন

অ্যাকাউন্ট ও প্রকল্পে প্রবেশাধিকার

অনুমোদিত IP ঠিকানা থেকে HTTPS সংযোগের মাধ্যমে একটি সক্রিয় API অ্যাকাউন্ট ব্যবহার করুন। প্রকল্পটি অবশ্যই ওই অ্যাকাউন্টের মালিকানাধীন হতে হবে এবং মুছে ফেলা হয়ে থাকলে চলবে না। পোর্টিং অর্ডারের কার্যপ্রবাহ থেকে পাওয়া প্রকল্পের অনন্য আইডি ব্যবহার করুন, ডেটাবেসে থাকা তার সংখ্যাসূচক আইডি বা কোনো ফোন নম্বর নয়। অনুরোধ তৈরি করার সময় প্রকল্পের আইডি URL-এনকোড করুন।

অনুরোধ

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

প্রতিক্রিয়া

প্রতিক্রিয়ার কাল্পনিক উদাহরণ।

{
  "status": {
    "code": 200,
    "msg": "Project Events",
    "results": 1
  },
  "response": [
    {
      "id": 31,
      "subject": "Example project update",
      "event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
      "type": "comment",
      "value": "Example update",
      "source": "Example source",
      "date_created": "2026-10-23 12:00:00"
    }
  ]
}

বিদ্যমান কোনো প্রকল্পে ইভেন্ট না থাকলে API কোড 200, একটি খালি তালিকা ফেরত আসে এবং status.results-এর মান হয় 0। ফলাফল তৈরির সময়ের অধঃক্রমে চাওয়া হয়; একই সময়ে তৈরি ফলাফলের জন্য অতিরিক্ত ক্রমবিন্যাস, পৃষ্ঠাভাগ, কার্সর বা তারিখের ফিল্টার নেই।

ইভেন্টের পেলোড মনোযোগ দিয়ে পড়ুন

id হলো ইভেন্টের সারির সংখ্যাসূচক আইডি, subject হলো তার সংরক্ষিত বিষয়, এবং date_created হলো তার সংরক্ষিত তারিখ/সময়ের মান। এন্ডপয়েন্টটি অপরিশোধিত event স্ট্রিং অক্ষুণ্ণ রাখে এবং সেটির নিম্নলিখিত বৈশিষ্ট্যগুলো ডিকোড করারও চেষ্টা করে: type, value এবং source। পেলোডটি JSON অবজেক্ট না হলে বা কোনো বৈশিষ্ট্য অনুপস্থিত থাকলে, সংশ্লিষ্ট পার্স করা ক্ষেত্রের মান একটি খালি স্ট্রিং হয়।

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

ইতিহাস সরবরাহের নিশ্চয়তা দেয় না

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

ত্রুটি ও সীমাবদ্ধতা

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

প্রভাব

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