ডেভেলপার

DELETE/tcr/v2/brand/{brandId}

মেসেজিং ব্র্যান্ডের ব্যবহার বন্ধ করুন

পোর্টালের সমন্বিত পরিষ্কারকরণ ও সরাসরি ব্র্যান্ড মুছে ফেলার মধ্যে উপযুক্ত পদ্ধতি বেছে নিন, তারপর ক্যাম্পেইন ও নম্বরের সংযুক্তি যাচাই করুন।

এই পৃষ্ঠায়
  1. ব্যবহার বন্ধ করার কর্মপ্রবাহ বেছে নিন
  2. পোর্টালে প্রভাব পর্যালোচনা করুন
  3. সরাসরি API দিয়ে মুছে ফেলার প্রস্তুতি নিন
  4. পর্যালোচনা করা ব্র্যান্ডটি মুছে ফেলুন
  5. ব্যবহার বন্ধ হওয়া যাচাই করুন ও আংশিক ফলাফল মিলিয়ে নিন
  6. অ্যাকাউন্টের অবশিষ্ট চার্জ পরীক্ষা করুন

ব্যবহার বন্ধ করার কর্মপ্রবাহ বেছে নিন

ব্যবসার আর ওই নিবন্ধনের প্রয়োজন না হলে মেসেজিং ব্র্যান্ডের ব্যবহার বন্ধ করুন। এতে বিদ্যমান নিবন্ধনের ব্যবহার বন্ধ হয়; এর বদলে নতুন নিবন্ধন করা হয় না, ভাড়া নেওয়া ফোন নম্বর ছেড়ে দেওয়া হয় না বা ব্যবসার পরিচয়সংক্রান্ত তথ্য সংশোধন করা হয় না। সংশোধনের জন্য এই বিকল্পটি ব্যবহার করুন: মেসেজিং ব্র্যান্ড হালনাগাদ করুন.

ব্র্যান্ডের পাবলিক DELETE কল এবং পোর্টালের ব্র্যান্ড মুছে ফেলার কাজের পরিধি আলাদা। পাবলিক কলটি রেজিস্ট্রির একটি ব্র্যান্ড মুছে ফেলে। পোর্টাল ব্র্যান্ড মুছে ফেলার চেষ্টা করার আগে নম্বরের সংযুক্তি বিচ্ছিন্ন করা ও ক্যাম্পেইন নিষ্ক্রিয় করার কাজ সমন্বয় করে।

ব্র্যান্ডের ব্যবহার বন্ধ করার বিকল্প
কর্মপ্রবাহযে কাজ করে
পোর্টাল: ব্র্যান্ড মুছে ফেলুনসংশ্লিষ্ট ক্যাম্পেইন ও সংযুক্ত নম্বর দেখায়, নিশ্চিতকরণের জন্য ব্র্যান্ড আইডি চায়, তারপর ব্র্যান্ড মুছে ফেলার আগে সংশ্লিষ্ট পরিষ্কারকরণের চেষ্টা করে। পরের কোনো ধাপ ব্যর্থ হলে আগের ধাপগুলোর সম্পন্ন করা কাজ বহাল থাকতে পারে।
API: DELETE /tcr/v2/brand/{brandId}শুধু এই অ্যাকাউন্টের মালিকানাধীন ব্র্যান্ডটি মুছে ফেলার অনুরোধ করে। এটি স্বয়ংক্রিয়ভাবে নম্বরের সংযুক্তি বিচ্ছিন্ন করে না বা ব্র্যান্ডের ক্যাম্পেইন নিষ্ক্রিয় করে না। সক্রিয় ক্যাম্পেইন থাকলে মুছে ফেলা বাধাগ্রস্ত হতে পারে।

পোর্টালে প্রভাব পর্যালোচনা করুন

মেসেজিং নিবন্ধনের পৃষ্ঠা খুলুন, সঠিক ব্র্যান্ডটি খুঁজে ব্র্যান্ড মুছে ফেলার বিকল্প বেছে নিন। সংশ্লিষ্ট ক্যাম্পেইন ও সংযুক্ত নম্বরের সংখ্যা পর্যালোচনা করুন। চূড়ান্ত কাজটি চালু করতে ব্র্যান্ডের হুবহু আইডি লিখুন। অ্যাকাউন্টের নিবন্ধন ব্যবস্থাপনার অনুমতি থাকলেই শুধু গ্রাহক ফর্মটি ব্যবহার করা যায়।

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

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

সরাসরি API দিয়ে মুছে ফেলার প্রস্তুতি নিন

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

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

পর্যালোচনা করা ব্র্যান্ডটি মুছে ফেলুন

ব্র্যান্ড আইডি যাচাই ও আগের পরিষ্কারকরণের কাজ সম্পন্ন করার পর কেবল নির্ধারিত ব্র্যান্ডের ব্যবহার বন্ধ করার উদ্দেশ্যেই নিচের নির্দেশ চালান। অনুরোধে কোনো JSON বডি নেই।

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

নথিভুক্ত সফল ফলাফল হলো HTTP 204, যাতে কোনো রেসপন্স বডি থাকে না। JSON সফলতার অবজেক্ট বা পুরোনো v3 status/response মোড়ক থাকা আবশ্যক ধরে নেবেন না। প্রত্যাখ্যাত non-2xx ফলাফল বর্তমান API সিঙ্ক্রোনাইজেশন প্রক্রিয়ার মাধ্যমে ব্র্যান্ডকে মুছে ফেলা হিসেবে চিহ্নিত করে না।

নির্ধারিত অনুরোধটির জন্য একটি আইডেমপোটেন্সি কী ব্যবহার করুন। একই অনুরোধ আবার পাঠালে মেথড, পাথ, কোয়েরি ও বডির বাইট অপরিবর্তিত রাখুন। এই কী পোর্টালের বৃহত্তর পরিষ্কারকরণকে সব কাজ একসঙ্গে সম্পন্ন হওয়া বা একটিও না হওয়ার নিশ্চয়তা দেয় না এবং অপারেটরের নম্বরের সংযুক্তি বিচ্ছিন্ন হয়েছে বলেও প্রমাণ করে না। প্রক্রিয়াধীন অনুরোধের সদৃশ অনুরোধে Retry-After-সহ 409 ফিরতে পারে; সম্পন্ন অনুরোধগুলোর সংরক্ষিত রেসপন্স আবার ফেরত আসতে পারে, এমনকি সেটি ত্রুটি হলেও।

ব্যবহার বন্ধ হওয়া যাচাই করুন ও আংশিক ফলাফল মিলিয়ে নিন

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

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

HTTP 400 হলে রেজিস্ট্রির বিস্তারিত ত্রুটি পড়ুন, বিশেষ করে সক্রিয় ক্যাম্পেইনসংক্রান্ত বিধিনিষেধ। 401, 403 বা 404 হলে প্রবেশের প্রমাণপত্র, অনুমোদিত উৎস আইপি ও অ্যাকাউন্টের মালিকানা পরীক্ষা করুন। 429 হলে Retry-After মেনে চলুন। বাইরের সিস্টেমে পরিবর্তন সম্পন্ন হওয়ার পরেও সময়সীমা পেরিয়ে যেতে পারে অথবা 500 বা 502 ফিরতে পারে; অনুরোধ আবার পাঠানোর আগে বিদ্যমান নিবন্ধন পরীক্ষা করুন।

অ্যাকাউন্টের অবশিষ্ট চার্জ পরীক্ষা করুন

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