HTTP/HTTPS ও REST API ডিজাইন

১ · HTTP মেথড ও স্ট্যাটাস কোড

HTTPHyperText Transfer Protocolওয়েবের যোগাযোগ প্রোটোকল — ক্লায়েন্ট একটি "মেথড" (GET, POST...) দিয়ে রিকোয়েস্ট পাঠায়, সার্ভার একটি "স্ট্যাটাস কোড"-সহ রেসপন্স পাঠায়। হলো ওয়েবের যোগাযোগ প্রোটোকল। প্রতিটি রিকোয়েস্টের একটি মেথড থাকে, যা বলে দেয় ক্লায়েন্ট কী করতে চাইছে —

সার্ভার প্রতিটি রিকোয়েস্টের সাথে একটি স্ট্যাটাস কোড রিটার্ন করে, যা রেসপন্সের ধরন বলে দেয় —

২ · HTTPS = HTTP + TLS

সাধারণ HTTP ডেটা প্লেইন টেক্সটে পাঠায় — মাঝপথে কেউ (ISP, পাবলিক Wi-Fi-এর অন্য কেউ) সেটা পড়ে ফেলতে পারে। HTTPS এই যোগাযোগ TLS দিয়ে এনক্রিপ্ট করে — প্রাথমিক হ্যান্ডশেকে অ্যাসিমেট্রিক ক্রিপ্টোগ্রাফি (RSA/ECC — discrete-math কোর্সের RSA পাঠের সাথে সরাসরি সম্পর্কিত) ব্যবহার করে একটি শেয়ারড কী নিরাপদে বিনিময় করে, তারপর বাকি যোগাযোগ দ্রুততর সিমেট্রিক এনক্রিপশন দিয়ে হয়। L40-এ আমরা এনক্রিপশনের এই পুরো প্রক্রিয়া ও কেন এভাবে ডিজাইন করা হয়েছে তা বিস্তারিত দেখব।

৩ · REST — রিসোর্স-ভিত্তিক API ডিজাইন

REST একটি আর্কিটেকচারাল স্টাইল, প্রোটোকল নয়। এর মূল নীতিগুলো —

• রিসোর্স-ভিত্তিক URL — URL একটি "noun" (বিশেষ্য) বোঝায়, যেমন /posts, ক্রিয়া (verb) নয় (/getPosts নয়)। কোন অপারেশন হবে তা ঠিক করে HTTP মেথড।
• স্টেটলেসনেস — প্রতিটি রিকোয়েস্টে সার্ভারের প্রয়োজনীয় সব তথ্য থাকে, সার্ভার আগের রিকোয়েস্ট মনে রাখে না (L12-এ stateless সার্ভিস ডিজাইনের সাথে সরাসরি সম্পর্কিত)।
• স্ট্যান্ডার্ড মেথড CRUD-এ ম্যাপ হয় — GET=Read, POST=Create, PUT/PATCH=Update, DELETE=Delete।
• আইডেম্পোটেন্সি — GET, PUT, DELETE একই রিকোয়েস্ট বারবার পাঠালে একই ফলাফল দেয় (একই রিসোর্সকে দুবার ডিলিট করলেও চূড়ান্ত অবস্থা একই — "নেই")। কিন্তু POST বারবার পাঠালে প্রতিবার একটি নতুন রিসোর্স তৈরি হতে পারে — নন-আইডেম্পোটেন্ট। এই পার্থক্য গুরুত্বপূর্ণ কারণ নেটওয়ার্ক ব্যর্থতার পর নিরাপদে রিট্রাই (L27) করা যায় শুধু আইডেম্পোটেন্ট অপারেশনে।

৪ · ওয়ার্কড উদাহরণ — "posts" রিসোর্সের REST ডিজাইন

৫ · কোডে দেখা — একটি মক REST API

নিচে একটি ইন-মেমরি dict-ভিত্তিক "posts" স্টোর দিয়ে একটি ছোট মক REST API — প্রতিটি ফাংশন একটি HTTP মেথডের সমতুল্য এবং একটি বাস্তবসম্মত স্ট্যাটাস কোড রিটার্ন করে।

posts_db = {}
next_id = 1

def get_all():
    return {"status": 200, "data": list(posts_db.values())}

def get_one(post_id):
    if post_id not in posts_db:
        return {"status": 404, "data": None}
    return {"status": 200, "data": posts_db[post_id]}

def create(title, body):
    global next_id
    post = {"id": next_id, "title": title, "body": body}
    posts_db[next_id] = post
    next_id += 1
    return {"status": 201, "data": post}

def update(post_id, title, body):
    if post_id not in posts_db:
        return {"status": 404, "data": None}
    posts_db[post_id] = {"id": post_id, "title": title, "body": body}
    return {"status": 200, "data": posts_db[post_id]}

def delete(post_id):
    if post_id not in posts_db:
        return {"status": 404, "data": None}
    del posts_db[post_id]
    return {"status": 204, "data": None}

# --- ডেমো: প্রতিটি অপারেশন ---
print("POST /posts:", create("প্রথম পোস্ট", "হ্যালো ওয়ার্ল্ড"))
print("POST /posts:", create("দ্বিতীয় পোস্ট", "আরেকটি পোস্ট"))
print("GET /posts:", get_all())
print("GET /posts/1:", get_one(1))
print("PUT /posts/1:", update(1, "প্রথম পোস্ট (আপডেটেড)", "নতুন কনটেন্ট"))
print("DELETE /posts/2:", delete(2))
print("GET /posts/2 (মুছে ফেলার পর):", get_one(2))