REST API with Flask: শুরু থেকে সমাপ্তি পর্যন্ত

আপনি যদি ওয়েব ডেভেলপমেন্টে আগ্রহী হন, তবে REST API সম্পর্কে জানাটা অত্যন্ত গুরুত্বপূর্ণ। REST API হল একটি সফটওয়্যার আর্কিটেকচার স্টাইল যা কম্পিউটার নেটওয়ার্কে বিভিন্ন সিস্টেমের মধ্যে ডেটা শেয়ারিংয়ের জন্য ব্যবহৃত হয়। Flask হল একটি পাইটন ফ্রেমওয়ার্ক যা REST API তৈরি করতে ব্যবহৃত হয়। এই আর্টিকেলে, আমরা শিখব কিভাবে Flask ব্যবহার করে একটি সহজ REST API তৈরি করা যায়।

Flask কী এবং কেন এটি REST API তৈরিতে ব্যবহৃত হয়?

Flask হল একটি মাইক্রো ফ্রেমওয়ার্ক যা পাইটন ভাষায় লেখা। এটি খুবই লাইটওয়েট এবং কমপ্লেক্সিটির জন্য সহজে ব্যবহারযোগ্য। Flask সাধারণত ছোট এবং মাঝারি আকারের ওয়েব অ্যাপ্লিকেশন তৈরি করতে ব্যবহৃত হয়। এটি RESTful API তৈরি করতে অত্যন্ত জনপ্রিয় কারণ এটি সহজে কনফিগারযোগ্য এবং দ্রুত প্রোটোটাইপ তৈরির জন্য উপযোগী।

Flask দিয়ে আপনি খুব সহজেই HTTP রিকোয়েস্ট যেমন GET, POST, PUT, DELETE হ্যান্ডল করতে পারবেন। এই সমস্ত কারণে Flask REST API তৈরির জন্য একেবারে আদর্শ।

Flask REST API তৈরি করার জন্য প্রথম পদক্ষেপ

Flask ব্যবহার করতে হলে প্রথমে আপনাকে আপনার সিস্টেমে এটি ইন্সটল করতে হবে। যদি আপনার সিস্টেমে Flask ইন্সটল না থাকে, তাহলে আপনি নিচের কমান্ডটি ব্যবহার করে এটি ইন্সটল করতে পারবেন:

pip install Flask

এখন Flask ইন্সটল করার পর, আপনি একটি ফাইল তৈরি করুন যেটি আপনার API সেভ করবে, যেমন app.py।

আমাদের প্রথম Flask API তৈরি করা

এখন আমরা একটি খুব সাধারণ Flask API তৈরি করব যেটি GET রিকোয়েস্ট হ্যান্ডল করবে এবং একটি JSON রেসপন্স ফিরিয়ে দেবে। নিচের কোডটি দেখুন:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api', methods=['GET'])
def get_data():
    return jsonify({"message": "Hello, World!"})

if __name__ == '__main__':
    app.run(debug=True)

এই কোডটি খুবই সাধারণ। এখানে /api রুটের জন্য একটি GET রিকোয়েস্ট হ্যান্ডল করা হয়েছে। যখন আপনি এই URL এ রিকোয়েস্ট পাঠাবেন, এটি একটি JSON রেসপন্স ফিরিয়ে দেবে যার মধ্যে একটি "Hello, World!" বার্তা থাকবে।

POST রিকোয়েস্টের জন্য Flask API

এখন আমরা একটি POST রিকোয়েস্ট হ্যান্ডল করতে পারি যা ইউজারের কাছ থেকে ডেটা গ্রহণ করবে। নিচের কোডটি দেখুন:

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api', methods=['POST'])
def post_data():
    data = request.get_json()
    name = data.get('name')
    return jsonify({"message": f"Hello, {name}!"})

if __name__ == '__main__':
    app.run(debug=True)

এই কোডে, আমরা একটি POST রিকোয়েস্ট গ্রহণ করছি যা JSON ফরম্যাটে ডেটা পাঠাবে। তারপর Flask সেই ডেটা নিয়ে একটি কাস্টম বার্তা রিটার্ন করবে।

Flask REST API তে Error Handling

API তৈরির সময় আপনার API এর ত্রুটি হ্যান্ডলিং অত্যন্ত গুরুত্বপূর্ণ। Flask এ আপনি সহজেই ত্রুটি হ্যান্ডলিং করতে পারবেন। নিচে একটি উদাহরণ দেওয়া হল যেখানে আমরা এক্সেপশন হ্যান্ডলিং ব্যবহার করেছি:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api', methods=['GET'])
def get_data():
    try:
        data = {'name': 'John'}
        return jsonify(data)
    except Exception as e:
        return jsonify({"error": str(e)}), 500

if __name__ == '__main__':
    app.run(debug=True)

এখানে যদি কোনো ত্রুটি ঘটে, Flask তা JSON ফরম্যাটে রিটার্ন করবে এবং HTTP স্টেটাস কোড 500 দেখাবে।

Flask REST API তে URL Parameters

আপনি যদি URL প্যারামিটার ব্যবহার করতে চান, তবে Flask এ এটি খুবই সহজ। এখানে একটি উদাহরণ দেওয়া হল যেখানে আমরা URL প্যারামিটার দিয়ে ডেটা গ্রহণ করছি:

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api/', methods=['GET'])
def greet(name):
    return jsonify({"message": f"Hello, {name}!"})

if __name__ == '__main__':
    app.run(debug=True)

এখানে, আমরা একটি ডাইনামিক প্যারামিটার ব্যবহার করেছি যেখানে আপনি URL তে নাম দিয়ে একটি কাস্টম বার্তা পেতে পারেন। যেমন: /api/John এ গেলে আউটপুট হবে “Hello, John!”

Flask REST API তে PUT এবং DELETE রিকোয়েস্ট

এখন আমরা PUT এবং DELETE রিকোয়েস্টগুলিও যুক্ত করব, যেগুলি সাধারণত ডেটা আপডেট এবং ডিলিট করার জন্য ব্যবহৃত হয়। নিচের কোডটি দেখুন:

from flask import Flask, request, jsonify

app = Flask(__name__)

data = {"name": "John"}

@app.route('/api', methods=['PUT'])
def update_data():
    new_data = request.get_json()
    data.update(new_data)
    return jsonify({"message": "Data updated successfully!"})

@app.route('/api', methods=['DELETE'])
def delete_data():
    data.clear()
    return jsonify({"message": "Data deleted successfully!"})

if __name__ == '__main__':
    app.run(debug=True)

এখানে, আমরা PUT রিকোয়েস্টের মাধ্যমে ডেটা আপডেট এবং DELETE রিকোয়েস্টের মাধ্যমে ডেটা মুছে ফেলার উদাহরণ দেখিয়েছি।

Flask REST API তে Authentication যোগ করা

যদি আপনি আপনার API তে অথেনটিকেশন যোগ করতে চান, তবে Flask এর Flask-HTTPAuth এক্সটেনশন ব্যবহার করতে পারেন। এই এক্সটেনশনটি ব্যবহার করে আপনি বেসিক অথেনটিকেশন যোগ করতে পারেন। উদাহরণস্বরূপ:

from flask import Flask, jsonify
from flask_httpauth import HTTPBasicAuth

app = Flask(__name__)
auth = HTTPBasicAuth()

users = {"admin": "password"}

@auth.verify_password
def verify_password(username, password):
    if users.get(username) == password:
        return username

@app.route('/api', methods=['GET'])
@auth.login_required
def get_data():
    return jsonify({"message": "You are authorized!"})

if __name__ == '__main__':
    app.run(debug=True)

এই উদাহরণে, আমরা বেসিক অথেনটিকেশন যোগ করেছি যেখানে admin ব্যবহারকারীর নাম এবং password পাসওয়ার্ড দিয়ে API অ্যাক্সেস করতে হবে।

নিষ্কর্ষ

Flask ব্যবহার করে REST API তৈরি করা অত্যন্ত সহজ এবং কার্যকর। আমরা এখানে Flask এর সাথে যুক্ত বিভিন্ন কমন ফিচার যেমন GET, POST, PUT, DELETE রিকোয়েস্ট, ত্রুটি হ্যান্ডলিং, URL প্যারামিটার, এবং অথেনটিকেশন যোগ করার উদাহরণ দেখিয়েছি। Flask এর সাহায্যে আপনি খুব দ্রুত এবং দক্ষতার সাথে শক্তিশালী RESTful API তৈরি করতে পারবেন। আশা করি, এই আর্টিকেলটি আপনাকে Flask ব্যবহার করে API তৈরি করতে সহায়তা করেছে।