ডেভেলপার

GET/v3/get_supporting_document_templates/{iso}

সহায়ক নথির টেমপ্লেটগুলির তালিকা দেখুন

সহায়ক নথি প্রস্তুত করার আগে টেমপ্লেটের আইডি, নাম এবং দেশের ইঙ্গিত খুঁজে নিন।

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

টেমপ্লেটের তালিকা দেখুন

পরিষেবা থেকে ফেরত পাওয়া টেমপ্লেটগুলির তালিকা দেখতে ঐচ্ছিক ISO পাথ অংশটি বাদ দিন। তালিকা ফিল্টার করতে একটি দেশের ISO কোড দিন। ফিল্টারটি টেমপ্লেটে থাকা দেশের ইঙ্গিতের সঙ্গে মিল খোঁজে; এই ইঙ্গিত নাম থেকে অনুমান করা হতে পারে এবং ফাঁকাও থাকতে পারে।

প্রয়োজনীয় শর্ত অনুযায়ী একটি টেমপ্লেট বেছে নিন

কোনো টেমপ্লেট তালিকায় থাকলেই সেটি ওই দেশের প্রতিটি নম্বরের জন্য প্রয়োজনীয় বা গ্রহণযোগ্য, এমন নয়। প্রযোজ্য সহায়ক নথির শর্তগুলির সঙ্গে টেমপ্লেটের আইডি মিলিয়ে নিন। এই তালিকা কোনো পূরণ করা নথি তৈরি, স্বাক্ষর, আপলোড বা অনুমোদন করে না।

কোনো টেমপ্লেট ফেরত না এলে

ফিল্টার করা তালিকা খালি হলে তার অর্থ হতে পারে যে দেশের কোনো মিলে যাওয়া ইঙ্গিত পাওয়া যায়নি। ফিল্টারবিহীন তালিকা খালি হওয়ার কারণও হতে পারে উজানের উৎস থেকে তথ্য না পাওয়া। কোনো ফলাফলকেই সহায়ক নথি প্রয়োজন নেই বলে প্রমাণ হিসেবে ধরবেন না।

ডাউনলোড করা অনুলিপি ব্যবহারের আগে পর্যালোচনা করুন

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

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

অনুরোধ

HTTPS-এর মাধ্যমে আপনার সক্রিয় API অ্যাকাউন্টের পরিচয়পত্র ব্যবহার করুন। Basic প্রমাণীকরণ এবং সক্রিয় API অ্যাকাউন্টের bearer টোকেন সমর্থিত; অ্যাকাউন্টের বিধিনিষেধ প্রযোজ্য।

URL পাথে নথিভুক্ত যেকোনো প্যারামিটার দিয়ে GET অনুরোধ করুন।

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"
পাথ প্যারামিটার
নামধরনআবশ্যকবিবরণ
isostringনাদেশের ISO কোডের ঐচ্ছিক ফিল্টার। ফিল্টারবিহীন তালিকার জন্য পাথের এই সম্পূর্ণ অংশটি বাদ দিন। তুলনার সময় বড় ও ছোট হাতের অক্ষরের পার্থক্য ধরা হয় না। অজানা বা অমিল মান দিলে দেশ অবৈধ বলে স্পষ্ট ত্রুটি দেখানোর পরিবর্তে একটি খালি তালিকা ফেরত আসে।

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

JSON বডির status.code এবং HTTP স্ট্যাটাস দুটিই পরীক্ষা করুন। response হলো id, name, permanent, iso এবং url থাকা অবজেক্টগুলির একটি অ্যারে। permanent একটি boolean মান; iso ফাঁকা থাকতে পারে এবং টেমপ্লেটের নাম থেকে অনুমান করা হয়ে থাকতে পারে। দেশের তথ্যকে একটি ইঙ্গিত হিসেবে ধরুন, যোগ্যতা নির্ধারণের সিদ্ধান্ত হিসেবে নয়। খালি তালিকা একটি সফল 200 প্রতিক্রিয়া; উজানের উৎসে অনুসন্ধান করে কোনো তথ্য না পাওয়া গেলেও এমন হতে পারে। পরিষেবা URL তৈরি করে; সেটির হোস্টনেম উদাহরণে দেখানো হোস্টনেম থেকে আলাদা হতে পারে।

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "TEMPLATE_ID_FROM_RESPONSE",
      "name": "Example supporting-document template",
      "permanent": false,
      "iso": "US",
      "url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
    }
  ]
}

ত্রুটি

  • প্রমাণীকরণ বা পরিষেবার ত্রুটির জন্য status.code এবং status.msg পরীক্ষা করুন। সফলভাবে ফেরত আসা খালি তালিকা কোনো নথির অনুমোদন বা নিবন্ধন থেকে অব্যাহতি নয়।

উপলভ্যতা ও পার্শ্বপ্রতিক্রিয়া

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