ডেভেলপার

GET/tcr/v2/brand/{brandId}/externalVetting

ব্র্যান্ডের যাচাইয়ের ফলাফল দেখুন

আপনার অ্যাকাউন্টের একটি ব্র্যান্ডের যাচাইয়ের ফলাফল পড়ুন এবং বিদ্যমান পর্যালোচনাটি অপেক্ষমাণ অবস্থা থেকে সফল বা ব্যর্থ ফলাফলে পৌঁছানো পর্যন্ত অনুসরণ করুন।

এই পৃষ্ঠায়
  1. যে ব্র্যান্ডটি পরীক্ষা করছেন সেটি নির্বাচন করুন
  2. বিদ্যমান পর্যালোচনার অগ্রগতি অনুসরণ করুন
  3. আগের অর্ডারের চার্জ বুঝে নিন
  4. আরেকটি অর্ডার জমা না দিয়ে তথ্য পড়ার চেষ্টা আবার করুন
  5. নিবন্ধনের ধাপগুলো আলাদা রাখুন
  6. অনুরোধ
  7. প্রতিক্রিয়া
  8. ত্রুটি
  9. উপলভ্যতা ও আনুষঙ্গিক প্রভাব

যে ব্র্যান্ডটি পরীক্ষা করছেন সেটি নির্বাচন করুন

আপনার অ্যাকাউন্টের ব্র্যান্ড আইডি ব্যবহার করুন। প্রাপ্ত যাচাইয়ের রেকর্ডগুলোর সঙ্গে এটি রাখুন, যাতে একটি ব্যবসার পর্যালোচনাকে অন্য ব্যবসার পর্যালোচনা বলে ভুল না হয়। অন্য অ্যাকাউন্টের শনাক্তকারী ব্যবহার করবেন না।

বিদ্যমান পর্যালোচনার অগ্রগতি অনুসরণ করুন

উপস্থিত থাকলে vettingId, evpId, vettingClass এবং vettingStatus সংরক্ষণ করুন। বর্তমান সমন্বয় প্রক্রিয়া PENDING এবং UNSCORE-কে আরও পরীক্ষার অপেক্ষায় থাকা ফলাফল হিসেবে এবং ACTIVE এবং FAILED-কে চার্জ নিষ্পত্তির জন্য চূড়ান্ত ফলাফল হিসেবে গণ্য করে। পরবর্তী কোনো পদক্ষেপ দরকার কি না, তা ঠিক করার আগে ফেরত পাওয়া বিস্তারিত তথ্য পড়ুন। শুধু একটি খালি তালিকা পাওয়া মানেই আগের জমা দেওয়া অনুরোধটি রেজিস্ট্রিতে পৌঁছায়নি—এমন প্রমাণ নয়।

আগের অর্ডারের চার্জ বুঝে নিন

অবস্থা পরীক্ষা করলে আরেকটি পর্যালোচনার অর্ডার হয় না। তবে এর মাধ্যমে সম্পন্ন ফলাফলের সঙ্গে সংরক্ষিত তথ্য মিলিয়ে আগের বিলযোগ্য পর্যালোচনার অনুরোধের চার্জ নিষ্পত্তি হতে পারে। প্রযোজ্য ব্যর্থতার চার্জও এর অন্তর্ভুক্ত। অর্ডার দেওয়ার সময় পর্যালোচনা করা মূল্য ও শর্ত ব্যবহার করুন; পুরোনো উদাহরণ বা অবস্থা জানানোর প্রতিক্রিয়া থেকে আজকের মূল্য অনুমান করবেন না।

আরেকটি অর্ডার জমা না দিয়ে তথ্য পড়ার চেষ্টা আবার করুন

সাময়িক ব্যর্থতা ঘটলে ব্র্যান্ড আইডি ও জানা যাচাইয়ের আইডিগুলো সংরক্ষণ করুন এবং Retry-After মেনে বিরতি ক্রমে বাড়িয়ে এই তথ্য পড়ার চেষ্টা আবার করুন। শুধু অবস্থা খোঁজার অনুরোধ ব্যর্থ হয়েছে বা অপ্রত্যাশিত প্রতিক্রিয়ার মূল অংশ ফিরেছে বলে নতুন পর্যালোচনার অর্ডার জমা দেবেন না। অমিল বজায় থাকলে প্রাসঙ্গিক রেফারেন্স আইডিগুলো দিয়ে প্রমাণীকৃত সহায়তা চ্যানেলের মাধ্যমে MultiTEL-এর সঙ্গে যোগাযোগ করুন।

নিবন্ধনের ধাপগুলো আলাদা রাখুন

যাচাইয়ের মাধ্যমে ব্র্যান্ডের জন্য একটি পর্যালোচনার ফলাফল নির্ধারিত হয়। ক্যাম্পেইনের যোগ্যতা যাচাই, ক্যাম্পেইন নিবন্ধন এবং নম্বর বরাদ্দ আলাদা ধাপই থাকে। বার্তা পাঠানোর আগে সেগুলোর বর্তমান অবস্থা ও প্রয়োজনীয় শর্ত পরীক্ষা করুন।

অনুরোধ

অনুমোদিত উৎস আইপি ঠিকানা থেকে 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"
পাথ প্যারামিটার
নামধরনআবশ্যকবিবরণ
brandIdঅক্ষরধারাহ্যাঁআপনার MultiTEL অ্যাকাউন্টের সঙ্গে যুক্ত রেজিস্ট্রির ব্র্যান্ড আইডি। এটি আপনার অ্যাকাউন্ট আইডি বা কোনো যাচাইয়ের আইডি নয়।
কোয়েরি প্যারামিটার
নামধরনআবশ্যকবিবরণ
vettingStatusঅক্ষরধারার অ্যারেহ্যাঁআবশ্যক অবস্থা ফিল্টার। অনুমোদিত মান: PENDING, UNSCORE, ACTIVE, FAILED, EXPIRED। উদাহরণে একটি ACTIVE মান দেওয়া হয়েছে; একাধিক মানের এনকোডিং বা ফিল্টার ছাড়া প্রদানকারীর অনুরোধ গ্রহণের কোনো দাবি করা হচ্ছে না।

প্রতিক্রিয়া

বর্তমান রুটটি পুরোনো v3 প্রতিক্রিয়ার আবরণ ব্যবহার করার পরিবর্তে রেজিস্ট্রির HTTP অবস্থা ও মূল অংশ অক্ষুণ্ণ রাখে। সংক্ষিপ্ত কাল্পনিক অ্যারেটি স্থানীয় সমন্বয় প্রক্রিয়ায় ব্যবহৃত ফিল্ডগুলো দেখায়; এটি রেজিস্ট্রি থেকে ধারণ করা প্রতিক্রিয়া নয়, কিংবা নিশ্চিতভাবে সম্পূর্ণ স্কিমাও নয়। রেকর্ড পড়ার আগে HTTP অবস্থা ও JSON পরীক্ষা করুন। প্রতিটি vettingId নির্বাচিত ব্র্যান্ডের সঙ্গে রাখুন।

প্রতিক্রিয়ার গঠন বোঝানোর উদাহরণ; এটি অ্যাকাউন্টের সরাসরি তথ্য বা বর্তমান মূল্যের প্রস্তাব নয়।

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

ত্রুটি

  • 401: অ্যাকাউন্টের প্রমাণীকরণ ব্যর্থ হয়েছে। প্রমাণীকরণ তথ্য, API সক্রিয় আছে কি না এবং প্রযোজ্য উৎস আইপি বিধিনিষেধ পরীক্ষা করুন।
  • 404: ব্র্যান্ডটি এই অ্যাকাউন্টের সঙ্গে যুক্ত নয়, অথবা রেজিস্ট্রি সেটিকে খুঁজে পায়নি। অ্যাকাউন্টের মালিকানার শর্ত পূরণ না হলে রেজিস্ট্রিতে অনুরোধ পাঠানোর আগেই তা প্রত্যাখ্যান করা হয়।
  • 429: অ্যাকাউন্ট বা রেজিস্ট্রির অনুরোধের সীমায় পৌঁছেছে। Retry-After মেনে চলুন এবং পুনরায় চেষ্টার মাঝে বিরতি ক্রমে বাড়ান।
  • 502/503: তথ্য পরিবহন, রেজিস্ট্রি, অনুরোধ সীমিতকারী বা স্থানীয় প্রক্রিয়াকরণ উপলভ্য নেই। কোনো ত্রুটি পাওয়া মানেই আগের পর্যালোচনার অনুরোধ ব্যর্থ হয়েছে—এটি প্রতিষ্ঠিত হয় না।

উপলভ্যতা ও আনুষঙ্গিক প্রভাব

  • এই GET নতুন যাচাইয়ের অর্ডার দেয় না। এটি রেজিস্ট্রির ফলাফল সংগ্রহ করে, অনুরোধের নিরীক্ষা রেকর্ড লেখে এবং সংরক্ষিত ফলাফল সমন্বয় করে।
  • সম্পন্ন ফলাফল পড়লে আগে দেওয়া বিলযোগ্য যাচাইয়ের অর্ডারের চার্জ নিষ্পত্তি হতে পারে। ব্যর্থ পর্যালোচনার জন্য প্রযোজ্য ব্যর্থতার চার্জ থাকতে পারে। অর্ডার দেওয়ার সময় মূল্য ও শর্ত পর্যালোচনা করুন; এই তথ্য পড়া কোনো মূল্যের প্রস্তাব নয়।
  • এই GET-এর মাধ্যমে আমদানি করা নতুনভাবে পাওয়া রেকর্ড স্বয়ংক্রিয়ভাবে নতুন বিলযোগ্য অর্ডার হিসেবে শ্রেণিবদ্ধ হয় না।
  • সফল বা ACTIVE যাচাইয়ের ফলাফল ক্যাম্পেইনের অনুমোদন, ফোন নম্বর বরাদ্দ বা বার্তা পাঠানোর অনুমতি নয়।