إعادة التحقق من علامة تجارية للمراسلة

إعادة فحص هوية النشاط التجاري بعد تصحيحها

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

استخدم حسابك المفعّل في API عبر HTTPS من عنوان بروتوكول إنترنت مصدري مسموح به. يجب أن تكون العلامة التجارية تابعة لذلك الحساب. حافظ على خصوصية سجلات العلامات التجارية، فهي تحتوي على معلومات النشاط التجاري وبيانات الاتصال.

مراجعة العلامة التجارية قبل الإرسال

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

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

تأكيد الرسوم المنفصلة

رسوم إعادة التحقق المضبوطة حاليا في بيئة الإنتاج هي 5.00 دولارات أمريكية لكل محاولة مقبولة، وقد جرى التحقق منها في 24 أكتوبر 2026. تُطبّق الرسوم القياسية للعلامة التجارية، حتى عندما يكون للكيان الأصلي سعر تسجيل مختلف. يجب تفعيل المشتريات؛ وتحتاج الحسابات مسبقة الدفع إلى رصيد كاف قبل الإرسال.

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

إرسال محاولة واحدة مقصودة

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

لا يلزم إرسال جسم طلب يحتوي على الملف، إذ تُفحص تفاصيل العلامة التجارية المخزنة بالفعل. استخدم مفتاحا فريدا لمنع تكرار التنفيذ للمحاولة المقصودة، وأبق طريقة الطلب ومساره واستعلامه وجسمه كما هي تماما عند إعادة المحاولة. تدعم المفاتيح 1–128 محرفا قابلا للطباعة من ASCII دون مسافات. قد يُرجع الطلب المكرر الذي لا يزال قيد التنفيذ الاستجابة 409 مع Retry-After؛ ويمكن للمحاولة المكتملة أن تعيد نتيجتها المحفوظة، بما في ذلك أي خطأ.

تقبل API العامة أيضا مصادقة Bearer لحساب مفعّل يستخدم رمزا مميزا. وتظل فحوص ملكية الحساب وعنوان بروتوكول الإنترنت المصدري المسموح به سارية. تتجاوز العلامات التجارية الوهمية المخزنة مسار رسوم الإنتاج هذا، لكن نتيجة البيئة التجريبية لا تُعد تحققا من الهوية في بيئة الإنتاج.

قراءة النتيجة ومتابعة حالتها

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

استيضاح نتيجة غير مؤكدة

قد يؤدي فشل النقل إلى استجابة 502 مخزنة مؤقتا. وإذا قُبل الطلب لدى الجهة الأعلى في سلسلة المعالجة ثم فشل الحفظ المحلي أو الفوترة، فقد ينتج عن ذلك استجابة 500 مخزنة مؤقتا تتضمن requestId. احتفظ بهذا المعرّف وراجع مع فريق الدعم الحالة الحالية للعلامة التجارية والفوترة لتسوية أي اختلاف. قد يؤدي إنشاء مفتاح آخر إلى إنشاء محاولة تُفرض عليها رسوم منفصلة؛ فلا تُعد المحاولة بمفتاح جديد دون استيضاح الحالة.

استخدام بوابة العملاء

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

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