নম্বর মজুত আছে এমন দেশগুলোর তালিকা

স্থানীয় নম্বর খোঁজা এখান থেকে শুরু করুন। তালিকায় শুধু সেই দেশগুলো থাকে, যেগুলোতে বর্তমানে নম্বর মজুত আছে। এটি কিছুই সংরক্ষণ করে রাখে না।

• প্যারামিটার isocode পাঠান getareas, getstates (শুধু US ও CA) অথবা other-এ।
• next_function সর্বদা নির্দেশ করে v3/getareas/{isocode}। যুক্তরাষ্ট্র ও কানাডার ক্ষেত্রে আপনি getstates আগে কল করে রাজ্য বা প্রদেশ অনুযায়ী অনুসন্ধানের পরিসর সীমিত করতে পারেন।
• is_mobile ও sms_coverage হলো দেশভিত্তিক ফ্ল্যাগ; এগুলো প্রতিটি নম্বরের জন্য নিশ্চয়তা দেয় না। যুক্তরাষ্ট্রের ক্ষেত্রে is_mobile এর মান 0 থাকে, যদি না আপনার অ্যাকাউন্টে যুক্তরাষ্ট্রের মোবাইল নম্বর ব্যবহারের সুবিধা সক্রিয় থাকে।
• যেসব দেশের কভারেজে নম্বর শুধু অর্ডারের মাধ্যমে পাওয়া যায়, সেসব দেশ তালিকায় থাকে না। তবুও আপনি getareas অথবা other সরাসরি কল করতে পারেন এমন কোনো দেশের জন্য, যা তালিকায় নেই।
• নির্দিষ্ট কোনো ক্রমে তালিকা প্রয়োজন হলে নিজেই তালিকাটি সাজিয়ে নিন।

কোনো দেশ শর্ত পূরণ না করলে response এর মান হয় null এবং status.code এর মান হয় 200।

অনুরোধ

আবশ্যক: HTTP Basic অথবা Bearer টোকেন (পরিচয় যাচাই এবং API-এর উত্তর বিষয়ক অংশ দেখুন)। পরিচয় যাচাই ব্যর্থ হলে অনুসন্ধান চালানোর আগেই HTTP 401 দিয়ে উত্তর দেওয়া হয়।

কোনো বডি ছাড়া GET অনুরোধ। একমাত্র প্যারামিটার হলো ঐচ্ছিক pid, যা কোয়েরি স্ট্রিংয়ে পাঠানো হয়।

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/getcountries'

উত্তর

উত্তরের মানক মোড়ক কাঠামো। সফল হলে status.code এর মান 200, status.msg এর মান 'Results: N', status.results এর মান N এবং response হলো দেশগুলোর তালিকা, যার ক্রমের কোনো নিশ্চয়তা নেই। ফিল্ডগুলো: countrycode ('+' ছাড়া দেশের কলিং কোড); name (দেশের নাম); description (name এর সমান মান); isocode (ISO 3166-1 alpha-2 কোড); is_mobile (0 অথবা 1, দেশভিত্তিক ক্যাটালগ ফ্ল্যাগ, US এর জন্য সর্বদা 0 থাকে, যদি না আপনার অ্যাকাউন্টে US এর মোবাইল নম্বর ব্যবহারের সুবিধা সক্রিয় থাকে); sms_coverage (0 অথবা 1, দেশভিত্তিক ক্যাটালগ ফ্ল্যাগ); latitude ও longitude (দেশের স্থানাঙ্ক); next_function ('v3/getareas/{isocode}')। কোনো দেশ কেবল তখনই তালিকাভুক্ত হয়, যখন সেটি দৃশ্যমান এবং তার অন্তত একটি প্রিফিক্সের জন্য বর্তমানে যেকোনো একটি মজুতের উৎসে নম্বর মজুত থাকে। যেসব দেশের সম্পূর্ণ কভারেজে নম্বর শুধু অর্ডারের মাধ্যমে পাওয়া যায় (কোনো মজুত নেই), সেসব দেশ তালিকায় থাকে না। এই মজুত যাচাইয়ের পরিসর getareas যে ফিল্টারগুলো প্রয়োগ করে সেগুলোর চেয়ে বিস্তৃত, তাই তালিকাভুক্ত কোনো দেশের জন্যও সেখানে মাঝেমধ্যে 'No areas found' ফেরত আসতে পারে। কোনো দেশ শর্ত পূরণ না করলে status.code এর মান 200, status.msg এর মান 'Results: 0', status.results ফিল্ড থাকে না এবং response এর মান হয় null।

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

{
  "status": {
    "code": 200,
    "msg": "Results: 2",
    "results": 2
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "38.0000",
      "longitude": "-97.0000",
      "next_function": "v3/getareas/US"
    },
    {
      "countrycode": "44",
      "name": "United Kingdom",
      "description": "United Kingdom",
      "isocode": "GB",
      "is_mobile": 1,
      "sms_coverage": 0,
      "latitude": "54.0000",
      "longitude": "-2.0000",
      "next_function": "v3/getareas/GB"
    }
  ]
}

ত্রুটি

• 401: পরিচয় যাচাইয়ের তথ্য অনুপস্থিত অথবা যাচাই ব্যর্থ হয়েছে। HTTP স্ট্যাটাস 401 সহ পাঠানো হয় (পরিচয় যাচাই এবং API-এর উত্তর বিষয়ক অংশ দেখুন)।

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

• শুধু তথ্য অনুসন্ধান করে। এটি কিছু সংরক্ষণ করে রাখে না, অর্ডার করে না বা পরিবর্তন করে না।
• ফলাফলে অনুরোধের সময়কার মজুতের অবস্থা প্রতিফলিত হয় এবং এক কল থেকে পরের কলের মধ্যে তা বদলে যেতে পারে।