REST API method: GET, POST, PUT, PATCH, DELETE সহজভাবে
প্রতিটি REST API method কী করে, to-do তালিকার উদাহরণ, সাধারণ status code, PUT বনাম PATCH আর safe ও idempotent মানে কী।
ছোট উত্তর: REST API method server-কে জানায় একটি resource নিয়ে আপনি কী করতে চান। GET পড়ে, POST নতুন বানায়, PUT পুরোটা বদলে দেয়, PATCH আংশিক বদলায়, আর DELETE মুছে ফেলে। এগুলো নিয়ম মেনে ব্যবহার করলে API সবার কাছে অনুমানযোগ্য হয়।
ধারণা: Resource আর Method
REST API জিনিসের নাম দেয় URL দিয়ে, যেমন to-do তালিকার জন্য /todos আর একটি আইটেমের জন্য /todos/7। HTTP method বলে দেয় কাজটা কী। একই URL-এর অর্থ method অনুযায়ী আলাদা হতে পারে।
প্রতিটি method উদাহরণসহ
GET: পড়া
GET /todos/7 সেই to-do ফেরত দেয়, কোনো body পাঠাতে হয় না। সাধারণ status: 200 OK (না থাকলে 404 Not Found)।
POST: নতুন বানানো
POST /todos-এ body {"title": "Buy milk", "done": false} পাঠালে নতুন to-do তৈরি হয়, id ঠিক করে server। সাধারণ status: 201 Created।
PUT: পুরোটা বদলানো
PUT /todos/7-এ body {"title": "Buy oat milk", "done": true} পাঠালে পুরো to-do আপনার পাঠানো জিনিস দিয়ে বদলে যায়। সাধারণ status: 200 OK বা 204 No Content।
PATCH: আংশিক বদলানো
PATCH /todos/7-এ body {"done": true} পাঠালে শুধু done ঘর বদলায়, বাকিগুলো যেমন ছিল তেমনই থাকে। সাধারণ status: 200 OK।
DELETE: মুছে ফেলা
DELETE /todos/7 আইটেমটি মুছে দেয়। সাধারণ status: 204 No Content।
PUT বনাম PATCH
ধরুন একটি to-do হলো {"title": "Buy milk", "done": false}।
{"done": true}দিয়ে PUT মানে “এটাই পুরো নতুন to-do”। কড়া API এটা বাতিল করতে পারে বাtitleমুছে দিতে পারে, কারণ আপনি তা পাঠাননি।{"done": true}দিয়ে PATCH মানে “শুধু এই ঘরটা বদলাও”। title “Buy milk”-ই থাকে।
মনে রাখার নিয়ম: PUT পুরো object পাঠায়, PATCH শুধু পরিবর্তনগুলো পাঠায়। নির্দিষ্ট API কেমন আচরণ করে তা তার documentation-এ থাকে, তাই সবসময় দেখে নিন।
Safe ও Idempotent সহজ ভাষায়
Safe মানে call-টি server-এ কিছু বদলায় না। GET safe।
Idempotent মানে একবার বা দশবার করলেও server একই অবস্থায় থাকে। GET, PUT ও DELETE idempotent: একই আইটেম দুবার মুছলেও তা মোছাই থাকে।
POST idempotent নয়: দুবার পাঠালে দুটো to-do তৈরি হতে পারে। তাই timeout-এর পর আবার চেষ্টা করতে সতর্ক হতে হয়। PATCH নির্ভর করে কীভাবে ডিজাইন করা হয়েছে তার উপর।
দ্রুত দেখে নেওয়ার ছক
Method | কাজ | উদাহরণ | Body | সাধারণ status | Safe | Idempotent |
|---|---|---|---|---|---|---|
GET | পড়া | GET /todos/7 | না | 200 | হ্যাঁ | হ্যাঁ |
POST | বানানো | POST /todos | হ্যাঁ | 201 | না | না |
PUT | পুরোটা বদলানো | PUT /todos/7 | হ্যাঁ (পুরোটা) | 200 বা 204 | না | হ্যাঁ |
PATCH | আংশিক বদলানো | PATCH /todos/7 | হ্যাঁ (পরিবর্তন) | 200 | না | নির্ভর করে |
DELETE | মোছা | DELETE /todos/7 | না | 204 | না | হ্যাঁ |
Python-এ চালিয়ে দেখা
নিচের code requests library আর একটি বানানো URL ব্যবহার করে, তাই আসল server-এ চলবে না। নিজের ব্যবহারযোগ্য একটা API বসিয়ে নিন।
import requests
BASE = "https://api.example.com/todos" # hypothetical URL
# GET: read the list
print(requests.get(BASE, timeout=10).json())
# POST: create a new to-do
r = requests.post(BASE, json={"title": "Buy milk", "done": False}, timeout=10)
todo = r.json()
print(r.status_code, todo) # expect 201
url = f"{BASE}/{todo['id']}"
# PATCH: change only one field
requests.patch(url, json={"done": True}, timeout=10)
# PUT: replace the whole to-do
requests.put(url, json={"title": "Buy oat milk", "done": True}, timeout=10)
# DELETE: remove it
r = requests.delete(url, timeout=10)
print(r.status_code) # expect 204HTTP method, status code ও header ঠিকমতো অনুশীলন করতে দেখুন HTTP method, status code, header ও JSON চ্যাপ্টারটি।
সাধারণ ভুল
Side effect-সহ GET:
GET /todos/7/delete-এর মতো link crawler বা prefetch-এ চালু হয়ে যেতে পারে। DELETE ব্যবহার করুন।সবকিছুতে POST: কাজ হয়, কিন্তু স্পষ্ট অর্থ হারায়, আর cache ও client আপনার API বুঝতে পারে না।
ভুল status code: error-এ 200 ফেরত দিলে সমস্যা লুকিয়ে যায়; প্রয়োজনমতো 201, 204, 400 ও 404 ব্যবহার করুন।
PUT-কে PATCH ভাবা এবং ভুলে ঘর মুছে ফেলা।
মূল কথা
GET পড়ে, POST বানায়, PUT বদলে দেয়, PATCH সম্পাদনা করে, DELETE মোছে। কোনটা safe ও idempotent তা মনে রাখুন, আর আপনি আসলে যা বোঝাতে চান সেই method-ই বাছুন।
শুরু করতে চান? API কীভাবে কাজ করে শিখুন এবং Git, Python ও FastAPI দিয়ে নিজের API বানান ও call করুন। শুরু করুন ফ্রি কোর্স AI-এর জন্য Git, API ও ব্যাকএন্ড: বিগিনার দিয়ে।
সম্পর্কিত লেখা
API ও ব্যাকএন্ড বিভাগের আরও লেখা
API key ও secret নিরাপদে রাখার নিয়ম (.env)
API key code-এর বাইরে রাখুন: .env ফাইল ও environment variable ব্যবহার করুন, Git-এ ignore করুন, আর key ফাঁস হলে ঠিক কী করবেন তা জানুন।
4 মিনিট পড়া১৪ নভে, ২০২৬Frontend আর Backend: পার্থক্য কী?
অ্যাপের frontend ও backend কী, দুটির পার্থক্য কোথায়, তারা কীভাবে কথা বলে এবং কেন AI কল ও গোপন key backend-এ থাকা উচিত।
3 মিনিট পড়া১২ নভে, ২০২৬HTTP status code: 200, 404, 500 মানে কী?
HTTP status code-এর মানে, 200, 404 ও 500 সহ পাঁচটি গ্রুপ কীভাবে কাজ করে এবং আপনার কোড প্রতিটিতে কীভাবে সাড়া দেবে।
3 মিনিট পড়া৯ নভে, ২০২৬JSON কী? API আর AI-তে কেন এত ব্যবহার হয়
JSON হলো কাঠামোবদ্ধ ডেটার সহজ text ফরম্যাট। এটি দেখতে কেমন, কী কী টাইপ আছে, Python-এ কীভাবে পড়বেন, আর API ও AI অ্যাপ কেন এর উপর নির্ভর করে, জানুন।
3 মিনিট পড়া৬ নভে, ২০২৬Git ও GitHub কী? পার্থক্য আর কেন শিখবেন
Git আপনার কম্পিউটারে কোডের ইতিহাস ট্র্যাক করে; GitHub সেটি অনলাইনে রাখে শেয়ার ও টিমওয়ার্কের জন্য। পার্থক্য, মূল শব্দ ও প্রথম কমান্ডগুলো জানুন।
3 মিনিট পড়া২ নভে, ২০২৬API কী এবং কীভাবে কাজ করে? সহজ উদাহরণে
রেস্টুরেন্টের উদাহরণে API, তারপর আসল অংশগুলো: endpoint, method, JSON, status code ও API key, সঙ্গে ছোট একটি Python উদাহরণ।
4 মিনিট পড়া৩১ অক্টো, ২০২৬
মন্তব্য
আলোচনায় যোগ দিতে সাইন ইন করুন।

