استخدم علامة تجارية للمراسلة مملوكة للحساب
استخدم حساب API مفعلا عبر HTTPS من عنوان IP مصدر مسموح به. تدعم الخدمة المصادقة باستخدام Basic وBearer. يجب أن يكون معرف العلامة التجارية تابعا لذلك الحساب. حافظ على سرية رموز المزود وبيانات هوية العلامة التجارية والتقارير المستلمة.
اطلب تدقيقا خارجيا جديدا
استخدم POST عندما تحتاج إلى أن يجري مزود التدقيق فحصا جديدا لهذه العلامة التجارية. إذا كانت لديك نتيجة من مزود بالفعل، فاستخدم الاستيراد بدلا من ذلك. هذه العملية منفصلة عن إعادة التحقق من هوية العلامة التجارية.
اطلع أولا على بيانات العلامة التجارية الحالية وأكد معلومات هويتها. اختر مزودا وفئة مدعومين من الكتالوجات الحالية وراجع متطلبات ذلك المزود. لا يدعم كل مزود جميع الفئات. يجب أن تصف التفاصيل الإضافية للتدقيق السياسي المؤسسة أو الحملة الفعلية، وألا تكون بيانات نموذجية.
جهز الطلب الموجه إلى المزود
| الحقل | القيمة |
|---|---|
| evpId | معرف المزود مطلوب من الكتالوج الحالي لمزودي التدقيق الخارجي، بطول 1–10 أحرف. |
| vettingClass | الفئة المدعومة التي تنوي شراءها؛ اخترها صراحة وأكد سعرها. |
| additionalRequestPayload | سلسلة نصية مرمزة بصيغة JSON تحتوي على تفاصيل خاصة بالمزود، وهي مطلوبة للتدقيق السياسي. إنها سلسلة نصية داخل كائن JSON الخارجي، وليست كائنا متداخلا. أكد جميع التفاصيل المطلوبة مع المزود المحدد. |
أكد رسوم النجاح والإخفاق
رسوم البيع بالتجزئة الحالية بالدولار الأمريكي، كما اطلع عليها في 24 أكتوبر 2026. أكد المبلغ الحالي قبل تقديم طلب فعلي. يتم التحقق من كفاية الرصيد المدفوع مسبقا لتغطية سعر النجاح؛ ويجب أن تكون المشتريات مفعلة.
| الفئة | نتيجة نشطة | نتيجة إخفاق |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL مع طلب Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
تحتفظ الطلبات المعلقة بمبالغ النجاح والإخفاق الخاصة بها، وتتم تسويتها عند مزامنة نتيجة ACTIVE أو FAILED. تطبق الفئتان الأخيرتان الرسم المضبوط نفسه على أي من النتيجتين النهائيتين. قد تحتسب رسوم النتيجة النهائية الفورية أثناء الاستجابة للطلب. ويمكن لمزامنة الحالة لاحقا تسوية رسوم معلقة.
لا تعتبر mock:true ضمانا لإجراء التدقيق الخارجي مجانا. قد يظل مسار التسوية الحالي للتدقيق الخارجي يسجل ذلك الطلب ويحتسب رسومه. لا تتطلب هذه التعليمات شراء فعليا للاختبار؛ استخدم بيانات اختبار معدة مسبقا دون اتصال إلى أن تنوي الإذن بإجراء تدقيق مدفوع.
أرسل طلبا واحدا بعد مراجعته
جهز vetting-order.json بمعرف المزود والفئة وأي معلومات إضافية مطلوبة. يحتوي الملف على الطلب الفعلي الذي تنوي إرساله. حافظ على سريته.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"تابع النتيجة الفعلية
قد تحتوي استجابة HTTP ناجحة على سجل تدقيق معلق. احتفظ بقيمة vettingId الخاصة به، وافحص vettingStatus والأسباب والدرجة وتاريخي السريان والانتهاء بحسب توفرها. تتطلب حالتا PENDING وUNSCORE مزيدا من المتابعة؛ وتصف ACTIVE وFAILED وEXPIRED نتائج مختلفة. لا يثبت القبول عبر HTTP وحده الحصول على درجة مواتية أو أهلية الحملة.
استخدم حالة التدقيق الخارجي لمتابعة السجل. قد تؤدي قراءة نتيجة نهائية أو استيرادها إلى تسوية طلب مدفوع سابق؛ ولا يعني ذلك بالضرورة عدم تحصيل رسوم قائمة لم تسدد بعد.
أعد محاولة إرسال الطلب المقصود نفسه
استخدم Idempotency-Key واحدا لكل عملية مقصودة، واحتفظ بطريقة الطلب والمسار وسلسلة الاستعلام وبايتات المتن كما هي تماما. تدعم المفاتيح 1–128 محرفا قابلا للطباعة من ASCII دون مسافات. قد تؤدي نسخة مكررة من طلب قيد التنفيذ إلى إرجاع 409 مع Retry-After. تعيد الطلبات المكتملة الاستجابة المخزنة لها، بما فيها الأخطاء. التزم بحدود معدل الطلبات.
قد تأتي استجابة 502 مخزنة مؤقتا بعد إخفاق في النقل. وقد تعني استجابة 500 مخزنة مؤقتا مع requestId أن السجل قبل العملية، لكن الحفظ الدائم المحلي أو الفوترة أخفقا. احتفظ بمعرف الطلب، وافحص السجلات الحالية، وسو الوضع مع فريق الدعم قبل استخدام مفتاح جديد. لا تفترض أن الخطأ يعني عدم وجود طلب.