اکاؤنٹ کی ملکیت والا پیغام رسانی کا برانڈ استعمال کریں
اجازت یافتہ ماخذ نیٹ ورک پتے سے HTTPS کے ذریعے فعال API اکاؤنٹ استعمال کریں۔ Basic اور Bearer توثیق کی معاونت دستیاب ہے۔ برانڈ کا شناخت کنندہ اسی اکاؤنٹ کا ہونا چاہیے۔ فراہم کنندہ کے ٹوکن، برانڈ کی شناختی معلومات اور موصول ہونے والی رپورٹیں نجی رکھیں۔
فراہم کنندہ کا موجودہ نتیجہ استعمال کریں
کسی معاونت یافتہ فراہم کنندہ کی جانچ کا موجودہ نتیجہ اپنے برانڈ سے منسلک کرنے کے لیے PUT استعمال کریں۔ اس سے نئی جانچ کا آرڈر نہیں دیا جاتا۔ فراہم کنندہ کی ٹرانزیکشن کا درست شناخت کنندہ اور تصدیقی ٹوکن، اگر کوئی ہو، براہ راست اسی فراہم کنندہ سے حاصل کریں، اور یقینی بنائیں کہ رپورٹ اسی کاروباری شناخت کی ہے۔
AUTHPLUS درآمد کے اس طریقۂ کار کی معاونت نہیں کرتا۔ فراہم کنندہ کے مخصوص مطابقتی قواعد بدستور لاگو ہوتے ہیں؛ درآمد کی درخواست ان سے استثنا نہیں دیتی اور نہ ہی مہم کے ہر استعمال کے لیے اہلیت کی ضمانت دیتی ہے۔
درآمد کی تیاری کریں
| خانہ | قدر |
|---|---|
| evpId | معاونت یافتہ فراہم کنندہ کا شناخت کنندہ، 1–10 حروف۔ |
| vettingId | فراہم کنندہ کی جانچ کی اصل ٹرانزیکشن کا شناخت کنندہ، زیادہ سے زیادہ 255 حروف۔ اس کی جگہ برانڈ کا شناخت کنندہ استعمال نہ کریں اور نہ ہی کوئی شناخت کنندہ خود بنائیں۔ |
| vettingToken | فراہم کنندہ کی جانب سے مطلوب ہونے پر تصدیقی ٹوکن، زیادہ سے زیادہ 65535 حروف۔ اسے خفیہ رکھیں اور جب فراہم کنندہ اسے طلب نہ کرے تو اسے شامل نہ کریں۔ |
فراہم کنندہ کی اصل قدروں سے 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 حروف کی معاونت ہے۔ زیر عمل درخواست کی نقل Retry-After کے ساتھ 409 لوٹا سکتی ہے۔ مکمل ہو چکی درخواستوں کا محفوظ شدہ جواب دوبارہ لوٹایا جاتا ہے، بشمول خرابیوں کے۔ درخواستوں کی شرح کی حدود کی پابندی کریں۔
ترسیل کی ناکامی کے بعد کیش میں محفوظ 502 جواب مل سکتا ہے۔ requestId کے ساتھ کیش میں محفوظ 500 جواب کا مطلب یہ ہو سکتا ہے کہ رجسٹری نے کارروائی قبول کر لی، لیکن مقامی طور پر مستقل محفوظ کرنا یا بلنگ ناکام ہو گئی۔ درخواست کا شناخت کنندہ محفوظ رکھیں، موجودہ ریکارڈ دیکھیں اور نئی کلید استعمال کرنے سے پہلے معاونت کی ٹیم کے ساتھ ریکارڈ اور واجبات کا معاملہ واضح اور درست کریں۔ یہ فرض نہ کریں کہ خرابی کا مطلب کوئی آرڈر موجود نہ ہونا ہے۔