اصلاح شدہ کاروباری شناخت دوبارہ جانچیں
یہ کارروائی اس وقت استعمال کریں جب کسی تنظیم کے موجودہ برانڈ کی اصلاح شدہ شناختی معلومات دوبارہ جانچنا ضروری ہو۔ پہلے موجودہ برانڈ کو اپ ڈیٹ کریں، پھر اس کی شناخت کی موجودہ حیثیت دیکھیں۔ پروفائل کی عام تازہ کاری سے الگ فیس والی یہ کوشش جمع نہیں ہوتی۔ دوبارہ تصدیق سے نہ دوسرا برانڈ بنتا ہے اور نہ کوئی مہم رجسٹر ہوتی ہے۔
اجازت یافتہ ماخذ IP سے HTTPS کے ذریعے اپنا فعال API اکاؤنٹ استعمال کریں۔ برانڈ اسی اکاؤنٹ کی ملکیت ہونا چاہیے۔ برانڈ کے ریکارڈ نجی رکھیں: ان میں کاروباری اور رابطے کی معلومات ہوتی ہیں۔
جمع کرانے سے پہلے برانڈ کا جائزہ لیں
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یقینی بنائیں کہ جواب میں ملنے والا برانڈ مطلوبہ کاروبار کا ہے اور اس میں اصلاح موجود ہے۔ اگر اصل رجسٹریشن ابھی زیر التوا ہے تو فی الحال دوبارہ تصدیق نہیں کی جا سکتی۔ کاروباری معلومات میں تبدیلی نہ ہونے پر رجسٹری درخواست مسترد کر سکتی ہے۔ خصوصی خصوصیات غائب ہونے کی صورت میں شناخت کی ایک اور جانچ کے بجائے اپیل درکار ہو سکتی ہے۔ واحد مالک کے کاروباروں کے برانڈز کے لیے شناخت/PIN کا موزوں طریقۂ کار استعمال ہوتا ہے؛ اس اینڈ پوائنٹ کو اس کا متبادل نہ سمجھیں۔
الگ فیس کی تصدیق کریں
پروڈکشن ماحول میں دوبارہ تصدیق کے لیے فی الحال مقرر کردہ فیس ہے: ہر قبول شدہ کوشش کے لیے US$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 حروف استعمال ہو سکتے ہیں۔ زیر کارروائی درخواست کی نقل پر Retry-After کے ساتھ 409 مل سکتا ہے؛ مکمل شدہ کوشش کا محفوظ نتیجہ، بشمول خرابی، دوبارہ واپس کیا جا سکتا ہے۔
عوامی API فعال ٹوکن اکاؤنٹ کے لیے Bearer توثیق بھی قبول کرتا ہے۔ اکاؤنٹ کی ملکیت اور اجازت یافتہ ماخذ IP کی جانچ بدستور لاگو رہتی ہے۔ محفوظ شدہ فرضی برانڈز پروڈکشن فیس کے اس عمل سے نہیں گزرتے، لیکن آزمائشی ماحول کا نتیجہ پروڈکشن میں شناخت کی تصدیق نہیں ہے۔
نتیجہ دیکھیں اور اس کی حیثیت کی پیروی کریں
| جواب | مطلب اور اگلا اقدام |
|---|---|
| 200 | درخواست کامیاب ہوئی۔ جواب میں ملنے والے برانڈ کا معائنہ کریں اور شناخت کی حیثیت کی تصدیق کے لیے برانڈ کا موجودہ ریکارڈ دوبارہ پڑھیں۔ |
| 202 | درخواست قبول ہو گئی ہے اور مزید تصدیق زیر التوا ہے۔ برانڈ کا شناختی نمبر محفوظ رکھیں اور فیس والی ایک اور کوشش جمع کرائے بغیر بعد میں اس کی موجودہ حیثیت دیکھیں۔ |
| 400 | جواب میں ملنے والی رجسٹری کی خرابیوں کا جائزہ لیں۔ اصل رجسٹریشن زیر التوا ہو سکتی ہے، پروفائل میں تبدیلی نہ ہوئی ہو سکتی ہے، یا جانچ کا کوئی اور اصول لاگو ہو سکتا ہے۔ |
| 401 / 404 | اسناد اور اجازت یافتہ IP، یا اکاؤنٹ کی ملکیت والے برانڈ کا شناختی نمبر جانچیں۔ |
| 402 / 503 | مقامی خریداری یا فنڈز، یا قیمت یا سروس سے متعلق خرابی کا جائزہ لیں۔ یہ فرض نہ کریں کہ ہر 503 اس بات کا ثبوت ہے کہ بالائی سروس کو کوئی درخواست نہیں بھیجی گئی۔ |
| 429 | Retry-After کی ہدایت پر عمل کریں اور کوشش کی تفصیلات وہی رکھیں۔ |
تبدیلی کی کارروائی قبول ہونے کے بعد پراکسی برانڈ کا اپنا مقامی ریکارڈ تازہ کرتی ہے؛ یہ تازہ کاری بذات خود تصدیق کے حتمی نتیجے کا ثبوت نہیں ہے۔ کاروبار غیر تصدیق شدہ یا زیر التوا رہ سکتا ہے۔ مہم کی ترتیب جاری رکھنے سے پہلے صرف HTTP کی سطح پر درخواست قبول ہونے پر انحصار کرنے کے بجائے برانڈ کی موجودہ حیثیت دیکھیں۔
غیر یقینی نتیجے کی صورت حال واضح کریں
ترسیل میں ناکامی سے کیش میں محفوظ 502 جواب بن سکتا ہے۔ بالائی سروس میں درخواست قبول ہونے کے بعد مقامی طور پر مستقل محفوظ کرنے یا بلنگ میں ناکامی ہو تو requestId کے ساتھ کیش میں محفوظ 500 جواب بن سکتا ہے۔ اس شناختی قدر کو محفوظ رکھیں اور معاونت کی ٹیم کے ساتھ برانڈ اور بلنگ کی موجودہ صورت حال کا حساب ملا کر تضادات دور کریں۔ دوسری کلید بنانے سے الگ قابل وصول فیس والی کوشش بن سکتی ہے؛ صورت حال جانے بغیر نئی کلید کے ساتھ دوبارہ کوشش نہ کریں۔
کسٹمر پورٹل کا استعمال
پورٹل موجودہ پروفائل اور فیس کا جائزہ لینے کے بعد پروڈکشن ماحول کی ایسی تنظیم کے لیے دوبارہ تصدیق کی سہولت دیتا ہے جس کی حیثیت UNVERIFIED ہو۔ یہ جانچتا ہے کہ پروفائل اور قیمت تبدیل نہیں ہوئے، اور انہی موجودہ تفصیلات کے لیے دوبارہ قبول ہونے والی درخواست جمع کرانے کو مسترد کرتا ہے۔ آزمائشی ماحول کے برانڈز اور واحد مالک کے کاروباروں کے برانڈز کے لیے پورٹل کی یہ کارروائی دستیاب نہیں ہے۔
پورٹل کے یہ حفاظتی اقدامات طریقۂ کار کی اضافی جانچیں ہیں۔ براہ راست API استعمال کرنے والے کلائنٹس کو خود جائزہ لینا چاہیے اور یہ فرض نہیں کرنا چاہیے کہ API میں پورٹل کے ورژن یا قیمت کی تصدیق والے فیلڈز درکار ہیں۔ برانڈ کی عام اصلاح محفوظ کرنا ایک الگ کارروائی ہے اور اس سے دوبارہ تصدیق کی درخواست خود بخود جمع نہیں ہوتی۔