الاطلاع على نتائج تدقيق علامة تجارية

اختر العلامة التجارية التي تريد التحقق منها

استخدم معرّف العلامة التجارية من حسابك. واحتفظ به مع سجلات التدقيق الناتجة حتى لا تختلط مراجعة منشأة بمراجعة منشأة أخرى. لا تستخدم معرّفات تخص حسابًا آخر.

تابع مراجعة قائمة

احتفظ بالحقول vettingId، evpId، vettingClass وvettingStatus عند توفرها. تتعامل آلية المزامنة الحالية مع PENDING وUNSCORE بوصفهما نتيجتين لا تزالان بانتظار مزيد من التحقق، ومع ACTIVE وFAILED بوصفهما نتيجتين نهائيتين لتسوية الرسوم. اقرأ التفاصيل المُعادة قبل أن تقرر ما إذا كانت هناك حاجة إلى متابعة. القائمة الفارغة وحدها لا تثبت أن إرسالًا سابقًا لم يصل إلى السجل.

تعرّف على رسوم طلب سابق

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

أعد محاولة القراءة دون تقديم طلب آخر

عند حدوث عطل مؤقت، احتفظ بمعرّف العلامة التجارية ومعرّفات التدقيق المعروفة، والتزم بما يحدده Retry-After وأعد محاولة هذه القراءة مع زيادة الفاصل الزمني بين المحاولات تدريجيًا. لا تقدّم طلب مراجعة جديدًا لمجرد فشل الاستعلام عن الحالة أو إعادته متن استجابة غير متوقع. إذا استمر عدم التطابق، فتواصل مع MultiTEL عبر قناة دعم تتطلب المصادقة، مع تقديم المعرّفات المرجعية ذات الصلة.

أبقِ خطوات التسجيل منفصلة

يُحدّد التدقيق نتيجة مراجعة للعلامة التجارية. ويظل تأهيل الحملة وتسجيلها وتخصيص الأرقام خطوات منفصلة. تحقّق من حالتها الحالية ومتطلباتها قبل إرسال الرسائل.

الطلب

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

استخدم GET مع معرّف العلامة التجارية في المسار ومرشّح الاستعلام الإلزامي vettingStatus. يحدّد المخطط الذي تمت مراجعته مصفوفة من الحالات؛ ويطلب هذا المثال قيمة واحدة هي ACTIVE. لا يثبت هذا الدليل طريقة ترميز القيم المتعددة ولا قبول المزوّد للطلبات دون مرشّح. لا يلزم إرسال متن للطلب.

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

الاستجابة

يحافظ المسار الحالي على حالة HTTP ومتن الاستجابة الواردين من السجل بدلًا من استخدام غلاف الاستجابة القديم v3. توضّح المصفوفة الافتراضية المختصرة الحقول التي يستخدمها مسار المزامنة المحلي؛ وهي ليست استجابة ملتقطة من السجل ولا مخططًا مضمون الاكتمال. تحقّق من حالة HTTP ومحتوى JSON قبل قراءة السجلات. احتفظ بكل vettingId مع العلامة التجارية المختارة.

بنية استجابة توضيحية؛ وليست بيانات حساب فعلية أو عرض سعر حاليًا.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

الأخطاء

• 401: فشلت مصادقة الحساب. تحقّق من بيانات الاعتماد وحالة تفعيل API والقيود المنطبقة على عنوان بروتوكول الإنترنت المصدر.
• 404: العلامة التجارية غير مرتبطة بهذا الحساب، أو تعذّر على السجل العثور عليها. يحدث الرفض المتعلق بتبعية العلامة التجارية للحساب قبل إرسال الطلب إلى السجل.
• 429: تم بلوغ حد الطلبات الخاص بالحساب أو السجل. التزم بما يحدده Retry-After وزِد الفاصل الزمني بين المحاولات تدريجيًا.
• 502/503: وسيلة النقل أو السجل أو محدّد معدل الطلبات أو المعالجة المحلية غير متاحة. لا يثبت حدوث خطأ أن طلب مراجعة سابقًا قد فشل.

التوفر والآثار الجانبية

• لا يقدّم طلب GET هذا طلب تدقيق جديدًا. بل يسترجع نتائج السجل، ويكتب سجلات تدقيق للطلبات، ويزامن النتائج المخزنة.
• قد تؤدي قراءة نتيجة مكتملة إلى تسوية رسوم طلب تدقيق خاضع للفوترة سبق تقديمه. وقد تترتب على المراجعة الفاشلة رسوم فشل إن كانت منطبقة. راجع السعر والشروط عند تقديم الطلب؛ فهذه القراءة ليست عرض سعر.
• لا يُصنَّف السجل المكتشف حديثًا والمستورَد بواسطة طلب GET هذا تلقائيًا على أنه طلب جديد خاضع للفوترة.
• لا تُعدّ نتيجة التدقيق الناجحة أو ذات الحالة ACTIVE موافقةً على الحملة، ولا تخصيصًا لرقم هاتف، ولا إذنًا بإرسال الرسائل.