ক্যাটালগের দেশগুলোর তালিকা (পুরোনো বিন্যাস)

এই পুরোনো এন্ডপয়েন্টটি একটি {"code", "data"} বডি ফেরত দেয়, প্রচলিত status/response এনভেলপের পরিবর্তে। এটি বিশেষ নম্বরের ক্যাটালগের সঙ্গে যুক্ত দৃশ্যমান দেশগুলোর তালিকা দেয় এবং মজুত যাচাই করে না।

নতুন ইন্টিগ্রেশনের জন্য:

• ব্যবহার করুন GET /v3/getcountries মজুতে নম্বর আছে এমন দেশ খুঁজে পেতে।
• ব্যবহার করুন GET /v3/other/{isocode} কোনো দেশে আসলে কোন ধরনের বিশেষ নম্বর দেওয়া হয় তা দেখতে। এখানে তালিকাভুক্ত কোনো দেশের জন্যও সেখানে খালি ক্যাটালগ ফেরত আসতে পারে।

অনুরোধ

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

কোনো প্যারামিটার বা বডি ছাড়া GET।

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

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

প্রচলিত এনভেলপ ছাড়া পুরোনো বডি: {code: 200, data: [...]}. এতে কোনো status অবজেক্ট, msg বা results ফিল্ড নেই। data-এ দেশগুলোর তালিকা থাকে, তবে ক্রমের কোনো নিশ্চয়তা নেই। ফিল্ডগুলো হলো: countrycode ('+' ছাড়া কলিং কোড), name, description (name-এর সমান মান), isocode, latitude এবং longitude। কোনো is_mobile, sms_coverage বা next_function ফিল্ড নেই। কোনো দেশ দৃশ্যমান হলে এবং বিশেষ নম্বরের ক্যাটালগের সঙ্গে যুক্ত থাকলে সেটি তালিকাভুক্ত হয়। মজুত যাচাই করা হয় না, তাই তালিকাভুক্ত কোনো দেশে বর্তমানে কোনো নম্বর উপলব্ধ না-ও থাকতে পারে। কোনো দেশ শর্ত পূরণ না করলে data-এর মান হয় null।

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

ত্রুটি

• 401: পরিচয় যাচাইয়ের তথ্য অনুপস্থিত অথবা পরিচয় যাচাই ব্যর্থ হয়েছে। HTTP status 401 সহ প্রচলিত status/response এনভেলপে পাঠানো হয়, পুরোনো বডিতে নয়।

উপলব্ধতা ও পার্শ্বপ্রভাব

• শুধু অনুসন্ধান করে। এটি কিছু সংরক্ষণ করে না, অর্ডার দেয় না বা পরিবর্তন করে না।