নির্দেশিকা

১. পোর্টাল লিংক

যে কোন কম্পিউটার অথবা মোবাইল ব্রাউজার থেকে https://sohojapi.vercel.app লিংকে ক্লিক করলেই সহজ এ.পি.আই'এর পৃষ্ঠা লোড হবে। পোর্টাল লোড হওয়ার পর আপনার স্ক্রিনে ওয়েব পেজের প্রথম/হোমপেইজে নির্দেশনা'তে এ.পি.আই ব্যবহারের নিয়মাবলী পাবেন।

২. Division বা বিভাগের এ.পি.আই ।

এরপর,উপরের বিভাগের এপিআই'টি কপি করে,api end-point হিসেবে ব্যবহার করতে পারেন। যেখানে সকল বিভাগ রয়েছে। এবং জেসন এর ধরণ নিম্নরুপঃ

[{
    "id":"1","name":"Chattagram","bn_name":"চট্টগ্রাম"
}]

কিংবা আপনি চাইলে ( https://sohojapi.vercel.app/api/divisions ) ব্র্যাকেটের ভিতরে থাকে এপিআই ইন্ড পয়েন্ডটি লিখে গুগল কিংবা অন্য কোনো ব্রাউজারের url বারে সার্চ দেন। তাহলে ৮ টি বিভাগের json file, show হবে। এতে আশা করি, আপনি উক্ত এপিআই ইন্ডপয়েন্টের বিভাগীয় json data সম্পর্কে এডভান্স অবগত হতে পারবেন বা জানতে পারবেন ইনশাআল্লাহ।

৩. District বা জেলা এ.পি.আই

তারপর, বাংলাদেশের সকল জেলা সংশ্লিষ্ট এপিআই পেতে উপরের জেলা এপিআই ইন্ডপয়েন্ট লিংক'টি কপি করুন। অতঃপর তা প্রয়োজনীয় ড্রপডাউন মেনুতে ব্যবহার করুন । এবং আপনি চাইলে ( https://sohojapi.vercel.app/api/districts ) ব্র্যাকেটের ভিতরে থাকে এপিআই ইন্ড পয়েন্ডটি লিখে গুগল কিংবা অন্য কোনো ব্রাউজারের url বারে সার্চ দেন। তাহলে ৬৪ টি জেলার json file, show হবে।API Structure : https://sohojapi.vercel.app/api/districts
/:divisionid এর মানে হলো, যখন কেউ ব্রাউজারের URL bar এ গিয়ে https://sohojapi.vercel.app/api/districts/1 লিখে তাহলে, চট্রগ্রাম বিভাগ সিলেক্ট হয়ে, সেই "চট্রগ্রাম" বিভাগের সকল জেলা json show করবে । এখানে চট্রগ্রাম বিভাগ কেন সিলেক্ট হলো?কারণঃ আপনি URL'এর শেষে divisionid এ 1 দিয়েছেন,আর 1 হলো চট্রগ্রামের ডিভিশন আইডি। আপনি যদি divisionid, 2 দিলে রাজশাহী সিলেক্ট হতো,কেননা divisionid, 2 হলো রাজশাহীর division id, তখন রাজশাহীর সকল জেলা প্রদর্শিত বা show হতো। ড্রপডাউন মেনুর সোর্সকোড অপশন আছে, Navbar থেকে সোর্সকোড পেজে গিয়ে সোর্স কোডগুলি ডাউনলোড করতে পারেন।

৪. Upzila বা উপজেলা'র এ.পি.আই

তারপর বাংলাদেশের সকল উপজেলা সংশ্লিষ্ট এপিআই পেতে উপরের জেলা এপিআই ইন্ডপয়েন্ট লিংক'টি কপি করুন। এবং তা প্রয়োজনানুসারে ড্রপডাউন লিংক এপিআই হিসেবে ব্যবহার করুন। বিভাগের ক্ষেত্রে, https://sohojapi.vercel.app/api/divisions এটা লিখে সার্চ দিলে সকল বিভাগের json ডেটা show বা প্রর্দশিত হয়েছে, জেলার ক্ষেত্রেও,আপনি যখন, https://sohojapi.vercel.app/api/districts লিখে সার্চ করেছেন,তখন সকল জেলার json data, show হয়েছে। কিন্তু আপনি যদি , https://sohojapi.vercel.app/api/upzila লিখে সার্চ দেন। তাহলে সকল উপজেলা ডেটা একসঙ্গে json আকারে শো করবে না। এটা security বা নিরাপত্তার জন্য ব্যবস্থা বিবেচনা করা হয়েছে। API Structure : https://sohojapi.vercel.app/api/upzilas/
:districtid যেখানে :districtid এর স্থলে 1,2,3..... ইত্যাদি সংখ্যা হতে পারে যা URL এ সার্চ বা অনুসন্ধান করে দেখা যেতে পারে।

৫. Union বা ইউনিয়নের এ.পি.আই

তারপর বাংলাদেশের সকল ইউনিয়ন সংশ্লিষ্ট এপিআই পেতে উপরের ইউনিয়ন এপিআই ইন্ডপয়েন্ট লিংক'টি কপি করুন। এবং তা প্রয়োজনানুসারে ড্রপডাউন লিংক এপিআই হিসেবে ব্যবহার করুন। উপজেলা'র এপিআই নিয়মের অনুরুপ, যেমন বিভাগের ক্ষেত্রে, https://sohojapi.vercel.app/api/divisions এটা লিখে সার্চ দিলে সকল বিভাগের json ডেটা show বা প্রর্দশিত হয়েছে, জেলার ক্ষেত্রেও,আপনি যখন, https://sohojapi.vercel.app/api/districts লিখে সার্চ করেছেন,তখন সকল জেলার json data, show হয়েছে। কিন্তু আপনি যদি , https://sohojapi.vercel.app/api/unions লিখে সার্চ দেন। তাহলে সকল উপজেলা ডেটা একসঙ্গে json আকারে শো করবে না। এটা security বা নিরাপত্তার জন্য ব্যবস্থা বিবেচনা করা হয়েছে। API Structure : https://sohojapi.vercel.app/api/unions/ :upzliasid যেখানে :upzilasid এর স্থলে 1,2,3..... ইত্যাদি সংখ্যা হতে পারে যা URL এ সার্চ বা অনুসন্ধান করে দেখা যেতে পারে।

৬. সারসংক্ষেপে কিছু কথা

উপরোক্ত তথ্য উপাত্তে ৮টি বিভাগ। ৬৪টি জেলা ৪৯৫টি উপজেলা, ও ৪৫৭৮টি ইউনিয়ন রয়েছে

ফর্ম এর সোর্স কোড দেওয়া আছে এই ওয়েবসাইটের Navbar এ লিংক থেকে ফর্ম পেজে গেলে সোর্সকোড ডাউনোড করতে পারবেন। সবাই অসংখ্য ধন্যবাদ। জাজাকাল্লাহু খাইরান।