پیغام رسانی کے برانڈ کا استعمال ختم کریں

استعمال ختم کرنے کا طریقۂ کار منتخب کریں

جب کاروبار کو اس رجسٹریشن کی مزید ضرورت نہ ہو تو پیغام رسانی کے برانڈ کا استعمال ختم کریں۔ اس سے موجودہ رجسٹریشن کا استعمال رک جاتا ہے؛ اس کے بدلے کوئی نئی رجسٹریشن نہیں ہوتی، کرائے کے فون نمبر آزاد نہیں ہوتے اور کاروبار کی شناخت کی تفصیلات درست نہیں ہوتیں۔ درستگی کے لیے یہ اختیار استعمال کریں: پیغام رسانی کا برانڈ اپ ڈیٹ کریں۔

برانڈ کی عوامی DELETE کال اور پورٹل کی برانڈ حذف کرنے کی کارروائی کا دائرۂ کار مختلف ہے۔ عوامی کال رجسٹری میں موجود ایک برانڈ حذف کرتی ہے۔ پورٹل برانڈ کو حذف کرنے کی کوشش سے پہلے نمبروں کی وابستگیاں ختم کرنے اور مہمات غیر فعال کرنے کی کارروائیوں کو مربوط کرتا ہے۔

پورٹل میں اثرات کا جائزہ لیں

پیغام رسانی کی رجسٹریشن کا صفحہ کھولیں، درست برانڈ تلاش کریں اور برانڈ حذف کرنے کا اختیار منتخب کریں۔ متعلقہ مہمات اور وابستہ نمبروں کی تعداد کا جائزہ لیں۔ حتمی کارروائی فعال کرنے کے لیے برانڈ کا بالکل درست شناخت کنندہ درج کریں۔ صارف کا فارم صرف اسی وقت دستیاب ہوتا ہے جب اکاؤنٹ کو رجسٹریشن کے انتظام کی اجازت حاصل ہو۔

پورٹل فعال مہمات پر باری باری کارروائی کرتا ہے: وہ ہر موجودہ وابستہ نمبر کی وابستگی ختم کرنے کی کوشش کرتا ہے، مہم غیر فعال کرتا ہے، اور پھر برانڈ حذف کرتا ہے۔ جن مہمات کو پہلے ہی میعاد ختم شدہ یا حذف شدہ نشان زد کیا گیا ہو، ان کے لیے وہ دوبارہ بیرونی نظام میں حذف کرنے کی کارروائی نہیں کرتا۔ ان بیرونی مراحل کی کامیابی کے بعد، وہ ڈیٹابیس کی ایک ٹرانزیکشن میں مہمات اور نمبروں کے مقامی ریکارڈ اپ ڈیٹ کرتا ہے۔

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

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 لفافے کی شرط نہ رکھیں۔ مسترد شدہ نتیجہ جس کا کوڈ 2xx کی حد میں نہ ہو، موجودہ API ہم وقت سازی کے راستے سے برانڈ کو حذف شدہ نشان زد نہیں کرتا۔

مطلوبہ درخواست کے لیے ایک ہی آئیڈیمپوٹینسی کلید استعمال کریں۔ درخواست دوبارہ بھیجتے وقت طریقہ، راستہ، استفسار اور باڈی کے بائٹس تبدیل نہ کریں۔ یہ کلید پورٹل کی وسیع تر صفائی کو ایسی واحد کارروائی نہیں بناتی جو یا تو پوری ہو یا بالکل نہ ہو، اور نہ ہی یہ ثابت کرتی ہے کہ ٹیلی کام کمپنی کے کسی نمبر کی وابستگی ختم ہو چکی ہے۔ جس درخواست پر ابھی کام جاری ہو، اس کی نقل Retry-After کے ساتھ 409 واپس کر سکتی ہے؛ مکمل شدہ درخواستیں اپنا محفوظ شدہ جواب دوبارہ واپس کر سکتی ہیں، بشمول خرابی کے جواب کے۔

استعمال ختم ہونے کی تصدیق کریں اور جزوی نتائج میں فرق دور کریں

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

پورٹل کا موجودہ ٹیلی کام کمپنی سے رابطے کا اڈاپٹر HTTP کی کامیابی کا جواب قبول کر لیتا ہے اور اس کی باڈی میں کاروباری حیثیت کی ہر قدر کی الگ سے توثیق نہیں کرتا۔ اسی لیے پورٹل کی صفائی کے بعد متاثرہ نمبروں کی مہمات کے ساتھ حقیقی وابستگیوں کی تصدیق کریں، خواہ پورٹل نے کامیابی ہی بتائی ہو۔ اگر کسی وابستگی یا حالت میں مطابقت نہ ہو تو متعلقہ شناخت کنندگان محفوظ رکھیں اور استعمال سے ہٹائے گئے سیٹ اپ کے ذریعے پیغامات بھیجنے یا اسے دوبارہ بنانے سے پہلے معاونت سے رابطہ کریں۔

HTTP 400 کی صورت میں رجسٹری کی تفصیلی خرابی پڑھیں، خاص طور پر فعال مہم کی وجہ سے عائد پابندی۔ 401، 403 یا 404 کی صورت میں اسناد، اجازت یافتہ ماخذ انٹرنیٹ پروٹوکول پتہ اور اکاؤنٹ کی ملکیت جانچیں۔ 429 کی صورت میں Retry-After کی ہدایت پر عمل کریں۔ بیرونی تبدیلی مکمل ہو جانے کے بعد بھی وقت ختم ہونے کی خرابی، 500 یا 502 آ سکتی ہے؛ درخواست دہرانے سے پہلے موجودہ رجسٹریشن کا معائنہ کریں۔

اکاؤنٹ کے باقی واجبات جانچیں

موجودہ DELETE سروس برانڈ کی رجسٹریشن کا فوری چارج عائد کرنے کی کارروائی نہیں بھیجتی۔ برانڈ حذف کرنے سے کرائے کے فون نمبر آزاد نہیں ہوتے، رقم واپس نہیں ملتی اور اکاؤنٹ کا حتمی بیلنس متعین نہیں ہوتا۔ پورٹل میں مہمات سے متعلق موجودہ مالی ذمہ داریوں، نمبروں کے کرائے اور استعمال کے چارجز کا جائزہ لیں۔ یہ کارروائی ان الگ خدمات کی قیمت کا تخمینہ نہیں ہے۔