إيقاف استخدام علامة تجارية للمراسلة

اختيار سير عمل إيقاف الاستخدام

أوقف استخدام علامة تجارية للمراسلة عندما لا تعود المنشأة بحاجة إلى ذلك التسجيل. يؤدي هذا إلى التوقف عن استخدام التسجيل الحالي؛ ولا يسجل بديلا عنه، ولا يلغي استئجار أرقام الهاتف، ولا يصحح تفاصيل هوية المنشأة. لإجراء تصحيح، راجع تحديث علامة تجارية للمراسلة.

يختلف نطاق استدعاء DELETE العام للعلامة التجارية عن نطاق إجراء حذف العلامة التجارية في البوابة. يحذف الاستدعاء العام علامة تجارية واحدة من السجل. وتنسق البوابة فك ارتباط الأرقام وإلغاء تنشيط الحملات قبل محاولة حذف العلامة التجارية.

مراجعة الأثر في البوابة

افتح صفحة تسجيل المراسلة، وابحث عن العلامة التجارية الصحيحة، واختر حذف العلامة التجارية. راجع عدد الحملات المرتبطة وعدد الأرقام المخصصة. أدخل معرف العلامة التجارية بدقة لتمكين الإجراء النهائي. لا يتاح نموذج العميل إلا عندما يمتلك الحساب إذن إدارة التسجيلات.

تعالج البوابة الحملات النشطة بالتتابع: تحاول فك ارتباط كل رقم مخصص حاليا، وتلغي تنشيط الحملة، ثم تحذف العلامة التجارية. وتتجاوز إجراء حذف آخر عن بعد للحملات المصنفة بالفعل على أنها منتهية الصلاحية أو محذوفة. بعد نجاح تلك الخطوات الخارجية، تحدث سجلات الحملات والأرقام المحلية ضمن معاملة في قاعدة البيانات.

لا يمثل هذا التسلسل معاملة ذرية واحدة تشمل السجل وشركة الاتصالات والسجلات المحلية. ولا يمكن لفشل لاحق استعادة رقم أو حملة سبق تغييرهما خارجيا. احتفظ بالتفاصيل المعادة عن الأرقام التي فك ارتباطها والحملات التي ألغي تنشيطها متى توفرت؛ وطابق النتائج باستخدام تلك المعرفات بدلا من إنشاء علامة تجارية أخرى.

التحضير للحذف المباشر عبر API

استخدم حساب API مفعلا عبر HTTPS من عنوان IP مصدر مسموح به. يجب أن تكون العلامة التجارية مملوكة لذلك الحساب. اطلع على معرفها وحالتها الحالية واحتفظ بهما، ثم تحقق من حملاتها وتخصيصات الأرقام. فك ارتباط الأرقام المتأثرة ونفذ الإجراء التالي: إلغاء تنشيط الحملات قبل حذف العلامة التجارية. لا تتعامل مع استدعاء 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.

استخدم مفتاحا واحدا لمنع تكرار الأثر للطلب المقصود. عند إعادة الطلب، أبق بايتات الطريقة والمسار والاستعلام والجسم دون تغيير. لا يجعل المفتاح إجراءات التنظيف الأوسع في البوابة ذرية، ولا يثبت فك ارتباط رقم لدى شركة الاتصالات. قد يعيد طلب مكرر لا يزال قيد المعالجة الرمز 409 مع Retry-After؛ ويمكن للطلبات المكتملة إعادة استجابتها المحفوظة، بما في ذلك استجابة خطأ.

التحقق من إيقاف الاستخدام ومطابقة النتائج الجزئية

تحقق من قوائم العلامات التجارية والحملات في البوابة ومن الأرقام المتأثرة بعد العملية. تضع المزامنة عند نجاح واجهة API العامة علامة الحذف محليا على العلامة التجارية المعنية؛ ولا تزيل موارد الحملات الأخرى أو تمحو تخصيصات الأرقام المشتراة. يتطلب كل من الحالة في السجل والتخصيص لدى شركة الاتصالات والعرض المحلي تحققا مستقلا.

يقبل موصل شركة الاتصالات الحالي في البوابة استجابة نجاح HTTP دون التحقق على نحو منفصل من كل قيمة لحالة العملية في جسمها. لذلك، تحقق من تخصيصات الأرقام المتأثرة الفعلية للحملات بعد التنظيف عبر البوابة، حتى لو أبلغت البوابة عن النجاح. إذا كان هناك عدم اتساق في تخصيص أو حالة، فاحتفظ بالمعرفات المتأثرة واتصل بالدعم قبل إرسال رسائل عبر الإعداد الذي أوقف استخدامه أو إعادة إنشائه.

عند ظهور HTTP 400، اقرأ الخطأ التفصيلي الوارد من السجل، وخاصة أي قيد يتعلق بحملة نشطة. وبالنسبة إلى 401 أو 403 أو 404، تحقق من بيانات الاعتماد وعنوان IP المصدر المسموح به وملكية الحساب للعلامة التجارية. وبالنسبة إلى 429، التزم بما يحدده Retry-After. قد يحدث انتهاء للمهلة أو يظهر الرمز 500 أو 502 بعد اكتمال تغيير خارجي؛ افحص التسجيل الحالي قبل تكرار الطلب.

التحقق من الرسوم المتبقية على الحساب

لا تطلق خدمة DELETE الحالية خصما فوريا لرسوم تسجيل العلامة التجارية. ولا يؤدي حذف العلامة التجارية إلى إلغاء استئجار أرقام الهاتف أو إصدار استرداد مالي أو تحديد الرصيد النهائي للحساب. راجع في البوابة أي التزامات قائمة للحملات ورسوم استئجار الأرقام والاستخدام. هذه العملية ليست عرض سعر لتلك الخدمات المنفصلة.