API Endpoints ও URL — কীভাবে পড়বেন

🎥 উপরে পুরো ভিডিওটি দেখে নিতে পারেন — অথবা নিচে পড়ে নিন। দুটোতেই একই জিনিস সহজ করে বোঝানো হয়েছে।

আগের পর্বে শিখেছি — method বলে দেয় কী করব (GET, POST, PUT, DELETE)। কিন্তু একটা অনুরোধ পাঠাতে হলে আরেকটা জিনিস লাগে: request-টা পাঠাব কোথায়? সেই ঠিকানাটাই হলো endpoint। আজ আমরা শিখব যেকোনো API-র URL একটা মানচিত্রের মতো করে পড়তে — একবার শিখে গেলে যেকোনো API ডকুমেন্টেশন আপনার কাছে সহজ মনে হবে।

Endpoint কী?

একটা API-কে ভাবুন বিশাল একটা বিল্ডিং হিসেবে। পুরো বিল্ডিংয়ের একটা ঠিকানা আছে — সেটা base URL (যেমন https://api.example.com)। ভেতরে অনেকগুলো রুম, প্রতিটি আলাদা কাজের জন্য। প্রতিটি রুমই একেকটা endpoint — যেমন /users (ইউজার সংক্রান্ত), /orders (অর্ডার সংক্রান্ত), /products (প্রোডাক্ট সংক্রান্ত)।

🏢 বিল্ডিং-রুমের উপমা

Base URL = বিল্ডিংয়ের ঠিকানা · Endpoint (path) = ভেতরের নির্দিষ্ট রুম। আপনি ঠিকানায় পৌঁছে তারপর নির্দিষ্ট রুমে যান — API-ও ঠিক তেমন।

একটা URL ভেঙে দেখা যাক

চলুন একটা সত্যিকারের API URL টুকরো টুকরো করে দেখি:

https://api.store.com/products?category=shoes

Base URL → https://api.store.com — বিল্ডিং (API-র মূল ঠিকানা)
Path (endpoint) → /products — কোন রুম (কোন জিনিস নিয়ে কাজ)
Query parameter → ?category=shoes — ফিল্টার/অপশন (শুধু জুতা দেখাও)

দুই ধরনের parameter: path vs query

এই দুটো নতুনরা প্রায়ই গুলিয়ে ফেলে, অথচ পার্থক্যটা সহজ:

1) Path parameter — নির্দিষ্ট একটা জিনিস

একটা নম্বর বা আইডি দিয়ে নির্দিষ্ট একটা জিনিস বোঝায়। যেমন:

/products/42   # ৪২ নম্বর প্রোডাক্ট
/users/7       # ৭ নম্বর ইউজার

এটা ঠিকানার অংশ — রুমের ভেতরের নির্দিষ্ট একটা তাক।

2) Query parameter — ফিল্টার বা অপশন

? চিহ্নের পরে আসে, আর তালিকাকে ছেঁকে দেয়। একাধিক হলে & দিয়ে জোড়া লাগে:

/products?category=shoes&sort=price   # জুতা, দাম অনুযায়ী সাজানো

সহজ নিয়ম: কোন জিনিস বোঝাতে path (/products/42), আর কীভাবে ছেঁকে দেখাব বোঝাতে query (?category=shoes)।

Method + Endpoint = যেকোনো কাজ

এবার আগের পর্বের method-গুলো এই endpoint-এর সাথে জুড়ে দিন — তখনই পুরো ছবিটা পরিষ্কার হয়:

Request	মানে
`GET /users`	সব ইউজার পড়া
`GET /users/5`	৫ নম্বর ইউজার পড়া
`POST /users`	নতুন ইউজার তৈরি
`PUT /users/5`	৫ নম্বর ইউজার আপডেট
`DELETE /users/5`	৫ নম্বর ইউজার মুছে ফেলা

খেয়াল করুন — একই endpoint (/users), কিন্তু method বদলালেই কাজ বদলে যায়। এটাই REST API-র সৌন্দর্য।

নতুনদের ২টি ভুল ধারণা

❌ "প্রতিটি কাজের জন্য আলাদা URL লাগে।" না — একই /users endpoint-এ GET, POST, DELETE দিয়ে আলাদা আলাদা কাজ করা যায়। URL এক, method আলাদা।
❌ "Query parameter আবশ্যক।" না — query parameter ঐচ্ছিক (optional)। ? ছাড়া endpoint পুরো তালিকা ফেরত দেয়; query শুধু ছেঁকে দেয়।

হাতে-কলমে: একটা সত্যিকারের endpoint পড়ুন

আগের পর্বের GitHub API মনে আছে? এবার একটা query parameter সহ চেষ্টা করুন — ব্রাউজারে এই ঠিকানায় যান:

https://api.github.com/users/torvalds/repos?per_page=5

ভেঙে দেখুন: base = api.github.com, path = /users/torvalds/repos (torvalds-এর রিপোগুলো), query = ?per_page=5 (শুধু ৫টা দেখাও)। এখন আপনি একটা URL শুধু তাকিয়েই "পড়তে" পারছেন! 🗺️

💡 মূল কথা

URL = base (বিল্ডিং) + path (রুম) + path parameter (নির্দিষ্ট জিনিস) + query (ফিল্টার)। আর method + endpoint মিলে যেকোনো কাজ বোঝানো যায়।

প্রায়ই জিজ্ঞেস করা প্রশ্ন (FAQ)

Endpoint আর URL — কি একই জিনিস?

প্রায় কাছাকাছি। URL হলো পুরো ঠিকানা (base + path + query), আর endpoint বলতে সাধারণত নির্দিষ্ট path-টাকে (/users) বোঝানো হয় — অর্থাৎ API-র কোন "রুমে" আপনি যাচ্ছেন।

একটা API-তে কয়টা endpoint থাকে?

নির্ভর করে। ছোট API-তে হয়তো ৩-৪টা, বড় API-তে (যেমন Facebook) শত শত। তবে পড়ার নিয়ম সবার একই — তাই একবার শিখলেই সব বুঝবেন।

পরবর্তী ধাপ

এখন আপনি method (কী), endpoint (কোথায়) — দুটোই জানেন। শেষ টুকরোটা বাকি: এই সব কিছুর ভেতর দিয়ে যে ডেটা যাওয়া-আসা করে, তার ফরম্যাট। পরের পর্বে আমরা শিখব JSON — API-দের সর্বজনীন ভাষা।

📧 প্রশ্ন আছে? hello@shadhinpath.com