استيراد نتيجة تدقيق موجودة

استخدم علامة تجارية للمراسلة يملكها الحساب

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

استخدم نتيجة موجودة لدى المزوّد

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

لا يدعم AUTHPLUS مسار الاستيراد هذا. تظل قواعد المطابقة الخاصة بالمزوّد سارية؛ ولا يعفي طلب الاستيراد من الالتزام بها ولا يضمن الأهلية لكل حالة استخدام للحملات.

جهّز عملية الاستيراد

أنشئ vetting-import.json باستخدام القيم الفعلية للمزوّد. لا ترسل حقول الدرجة أو الحالة أو الطابع الزمني المخصصة للاستجابة فقط وكأنها تستطيع تغيير النتيجة.

استورد النتيجة مرة واحدة

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @vetting-import.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"

تعرّف على الرسوم القائمة

لا يسجّل هذا الوسيط النتيجة المستوردة حديثًا كطلب جديد مدفوع. ولا يلغي ذلك تدقيقًا طُلب سابقًا: إذا كان هناك بالفعل طلب ينتظر النتيجة أو ينتظر تحصيل الرسوم للمعرّف vettingId نفسه، فقد يؤدي استيراد نتيجة بحالة ACTIVE أو FAILED إلى تسوية الرسوم المحفوظة لذلك الطلب. لا يفرض فرع المزامنة هذا الرسوم مجددًا على سجل سبق تحصيل رسومه.

تابع النتيجة الفعلية

قد تحتوي استجابة HTTP الناجحة على سجل تدقيق قيد الانتظار. احتفظ بمعرّف vettingId الخاص به وراجع vettingStatus والأسباب والدرجة وتواريخ السريان والانتهاء بحسب توافرها. تتطلب الحالتان PENDING وUNSCORE مزيدًا من المتابعة؛ وتصف الحالات ACTIVE وFAILED وEXPIRED نتائج مختلفة. لا يثبت القبول على مستوى HTTP وحده الحصول على درجة مواتية أو الأهلية للحملة.

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

أعد محاولة الطلب نفسه للعملية المقصودة

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

قد تظهر استجابة 502 محفوظة في الذاكرة المؤقتة بعد فشل في النقل. وقد تعني استجابة 500 محفوظة في الذاكرة المؤقتة وتتضمن requestId أن السجل المركزي قبل العملية، لكن الحفظ الدائم محليًا أو الفوترة فشل. احتفظ بمعرّف الطلب، وراجع السجلات الحالية، وسوِّ الحالة مع فريق الدعم قبل استخدام مفتاح جديد. لا تفترض أن الخطأ يعني عدم وجود طلب.