کسی برانڈ کی جانچ کے نتائج دیکھیں

وہ برانڈ منتخب کریں جس کی آپ جانچ کر رہے ہیں

اپنے اکاؤنٹ کا برانڈ شناخت کنندہ استعمال کریں۔ اسے حاصل ہونے والے جانچ کے ریکارڈز کے ساتھ محفوظ رکھیں تاکہ ایک کاروبار کی جانچ کو غلطی سے دوسرے کاروبار کی جانچ نہ سمجھا جائے۔ کسی دوسرے اکاؤنٹ کے شناخت کنندگان استعمال نہ کریں۔

موجودہ جانچ کی پیش رفت دیکھیں

یہ شناختی معلومات محفوظ رکھیں: vettingId, evpId, vettingClass اور vettingStatus، جب یہ موجود ہوں۔ موجودہ ہم وقت سازی میں PENDING اور UNSCORE کو ایسے نتائج سمجھا جاتا ہے جو ابھی مزید جانچ کے منتظر ہیں، جبکہ ACTIVE اور FAILED کو چارج کے تصفیے کے لیے حتمی نتائج سمجھا جاتا ہے۔ یہ فیصلہ کرنے سے پہلے کہ مزید کارروائی درکار ہے یا نہیں، واپس آنے والی تفصیلات پڑھیں۔ صرف خالی فہرست اس بات کا ثبوت نہیں کہ پہلے جمع کرائی گئی درخواست رجسٹری تک نہیں پہنچی تھی۔

پہلے دیے گئے آرڈر کے چارجز سمجھیں

حیثیت دیکھنے سے دوسری جانچ کا آرڈر نہیں دیا جاتا۔ تاہم، اس سے مکمل شدہ نتیجے کا ریکارڈ سے ملاپ ہو سکتا ہے اور پہلے کی ایسی جانچ کی درخواست سے متعلق چارج کا تصفیہ ہو سکتا ہے جس پر فیس واجب ہوتی ہے۔ اس میں ناکامی کا چارج بھی شامل ہے، اگر وہ لاگو ہو۔ وہی قیمت اور شرائط استعمال کریں جن کا آرڈر دیتے وقت جائزہ لیا گیا تھا؛ کسی پرانی مثال یا حیثیت کے جواب سے آج کی قیمت اخذ نہ کریں۔

دوسرا آرڈر دیے بغیر معلومات پڑھنے کی دوبارہ کوشش کریں

عارضی ناکامی کی صورت میں برانڈ اور جانچ کے معلوم شناخت کنندگان محفوظ رکھیں، اس ہدایت کی پابندی کریں: Retry-After اور کوششوں کے درمیان وقفہ بڑھاتے ہوئے معلومات پڑھنے کی دوبارہ کوشش کریں۔ صرف اس وجہ سے جانچ کا نیا آرڈر نہ دیں کہ حیثیت معلوم کرنے کی کوشش ناکام ہوئی یا جواب کا غیر متوقع متن واپس آیا۔ اگر عدم مطابقت برقرار رہے تو تصدیق شدہ معاونتی ذریعے سے متعلقہ حوالہ جاتی شناخت کنندگان کے ساتھ MultiTEL سے رابطہ کریں۔

رجسٹریشن کے مراحل الگ رکھیں

جانچ سے برانڈ کے لیے جائزے کا نتیجہ متعین ہوتا ہے۔ مہم کی اہلیت کا تعین، مہم کی رجسٹریشن اور نمبر کی تخصیص الگ مراحل رہتے ہیں۔ پیغامات بھیجنے سے پہلے ان کی موجودہ حیثیت اور تقاضے دیکھیں۔

درخواست

اجازت یافتہ ماخذ IP پتے سے HTTPS کے ذریعے فعال API اکاؤنٹ استعمال کریں۔ اپنے اکاؤنٹ کی اسناد استعمال کریں، رجسٹری کی اسناد نہیں۔ برانڈ کا تعلق اس اکاؤنٹ سے ہونا ضروری ہے جس کی توثیق کی گئی ہے۔

راستے میں برانڈ شناخت کنندہ اور لازمی vettingStatus استفساری فلٹر کے ساتھ GET درخواست دیں۔ جائزہ لیے گئے اسکیما میں حیثیتوں کی ایک صف متعین ہے؛ یہ مثال 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"

جواب

موجودہ راستہ پرانے v3 جوابی لفافے کو استعمال کرنے کے بجائے رجسٹری کی HTTP حیثیت اور جواب کا متن برقرار رکھتا ہے۔ یہ مختصر فرضی صف مقامی ہم وقت سازی کے عمل میں استعمال ہونے والے خانوں کی مثال دکھاتی ہے؛ یہ رجسٹری سے محفوظ کیا گیا اصل جواب نہیں، نہ ہی اس کے مکمل اسکیما ہونے کی ضمانت ہے۔ ریکارڈز پڑھنے سے پہلے HTTP حیثیت اور JSON دیکھیں۔ ہر vettingId کو منتخب برانڈ کے ساتھ محفوظ رکھیں۔

جواب کی ساخت کی مثال؛ یہ اکاؤنٹ کا براہِ راست ڈیٹا یا موجودہ قیمت کی پیشکش نہیں ہے۔

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

خرابیاں

• 401: اکاؤنٹ کی توثیق ناکام ہوئی۔ اسناد، API کی فعال حالت اور ماخذ IP پر لاگو پابندیاں دیکھیں۔
• 404: برانڈ اس اکاؤنٹ سے وابستہ نہیں ہے، یا رجسٹری اسے تلاش نہیں کر سکی۔ اکاؤنٹ کی ملکیت کی بنیاد پر رسائی مسترد کیے جانے کا عمل رجسٹری کو درخواست بھیجنے سے پہلے ہوتا ہے۔
• 429: اکاؤنٹ یا رجسٹری کی درخواستوں کی حد پوری ہو گئی ہے۔ Retry-After کی پابندی کریں اور کوششوں کے درمیان وقفہ بڑھائیں۔
• 502/503: ترسیل، رجسٹری، درخواستوں کو محدود کرنے والا نظام یا مقامی پراسیسنگ دستیاب نہیں ہے۔ کسی خرابی سے یہ ثابت نہیں ہوتا کہ جانچ کی پچھلی درخواست ناکام ہو گئی تھی۔

دستیابی اور ضمنی اثرات

• یہ GET جانچ کا نیا آرڈر نہیں دیتی۔ یہ رجسٹری سے نتائج حاصل کرتی ہے، درخواستوں کے آڈٹ ریکارڈز لکھتی ہے اور محفوظ شدہ نتائج کو ہم وقت کرتی ہے۔
• مکمل شدہ نتیجہ پڑھنے سے جانچ کے کسی پہلے سے دیے گئے آرڈر کے چارج کا تصفیہ ہو سکتا ہے جس پر فیس واجب ہوتی ہے۔ ناکام جانچ پر ناکامی کا چارج لگ سکتا ہے، اگر وہ لاگو ہو۔ آرڈر دیتے وقت قیمت اور شرائط کا جائزہ لیں؛ معلومات پڑھنے کی یہ کارروائی قیمت کی پیشکش نہیں ہے۔
• اس GET کے ذریعے درآمد ہونے والا نیا دریافت شدہ ریکارڈ خودکار طور پر ایسے نئے آرڈر کے طور پر درجہ بند نہیں ہوتا جس پر فیس واجب ہو۔
• جانچ کا کامیاب نتیجہ یا ACTIVE حیثیت مہم کی منظوری، فون نمبر کی تخصیص یا پیغامات بھیجنے کی اجازت نہیں ہے۔