Flask ile REST API Yapmak Neden Bu Kadar Kolay?
Bir gün, yazılım dünyasında gezindiğiniz sırada, basit ama güçlü bir web framework'ü arayışına girdiniz. İşte o zaman, Flask karşınıza çıktı. Basit, hafif ve esnek yapısıyla, Flask'ı kullanarak çok kısa bir sürede RESTful bir API oluşturabileceğinizi öğrendiniz.
Flask ile REST API yapmak, aslında düşündüğünüz kadar karmaşık değil. Python’un gücünden faydalanarak hızlıca API oluşturmak istiyorsanız, doğru yerdesiniz. Bu yazıda, Flask ile REST API nasıl yapılır adım adım anlatacağım. Hazırsanız, gelin Flask’la web dünyasına ilk adımınızı birlikte atalım.
Başlangıç: Flask'ı Projeye Dahil Etmek
Flask'ı kullanmak için öncelikle projenize dahil etmeniz gerekiyor. Flask, Python tabanlı hafif bir framework olduğu için kolayca kurulur. Şimdi, başlamak için Flask'ı bilgisayarınıza kurmalısınız.
Adım 1: Flask’ı Kurun
Terminal ya da komut satırınızı açın ve şu komutu girin:
pip install flask
Bu komut, Flask'ı projenize dahil eder ve onu kullanmaya hazır hale getirir.
Flask Uygulamanızı Oluşturma
Adım 2: Basit Bir Flask Uygulaması Oluşturun
Flask ile basit bir API yapmak için şu adımları takip edebiliriz. Flask uygulamanızı başlatın ve birkaç temel rota ekleyin.
from flask import Flask, jsonify
app = Flask(__name__)
@app.route('/api', methods=['GET'])
def home():
return jsonify({"message": "Flask API'ye Hoşgeldiniz!"})
if __name__ == "__main__":
app.run(debug=True)
Yukarıdaki kodda, temel bir Flask uygulaması oluşturduk. `/api` rotası, bir GET isteği aldığında basit bir mesaj döndürüyor. Burada, `jsonify` fonksiyonu ile veriyi JSON formatında döndürüyoruz. Flask’ın sunduğu en güzel özelliklerden biri, Python nesnelerini kolayca JSON’a dönüştürmesi.
Adım 3: API'yi Çalıştırın
Yukarıdaki kodu bir dosyaya kaydedin (örneğin, `app.py` olarak). Terminal üzerinden bu dosyayı çalıştırarak API’nizi başlatabilirsiniz:
python app.py
Şimdi tarayıcınızdan `http://127.0.0.1:5000/api` adresine gidin. Eğer her şey doğruysa, "Flask API'ye Hoşgeldiniz!" mesajını görmelisiniz.
API'yi Geliştirmek: POST, PUT, DELETE Metodları
Adım 4: API'nize POST, PUT ve DELETE Ekleme
Artık basit bir GET API'miz var. Ancak gerçek dünya API'lerinde genellikle veri ekleme, güncelleme ve silme işlemleri de yapılır. Flask ile bu işlemleri kolayca gerçekleştirebilirsiniz.
POST Metodu: Yeni Veri Ekleme
Veri eklemek için POST metodunu kullanabiliriz. İşte örnek bir POST isteği:
from flask import request
@app.route('/api/users', methods=['POST'])
def add_user():
data = request.get_json() # JSON verisini alıyoruz
name = data.get("name")
age = data.get("age")
return jsonify({"message": f"{name} adlı kullanıcı {age} yaşında başarıyla eklendi!"}), 201
Bu kod parçası, `/api/users` adresine gelen POST isteği ile bir kullanıcının adını ve yaşını alıp, başarıyla eklediğini belirten bir mesaj döner.
PUT Metodu: Veri Güncelleme
Bir kullanıcıyı güncellemek için PUT metodunu kullanabilirsiniz. İşte basit bir örnek:
@app.route('/api/users/', methods=['PUT'])
def update_user(id):
data = request.get_json()
name = data.get("name")
age = data.get("age")
return jsonify({"message": f"{id} numaralı kullanıcı güncellendi: {name}, {age} yaşında."})
Bu örnekte, bir kullanıcının verileri, kullanıcı ID'si ile güncellenmektedir.
DELETE Metodu: Veri Silme
Bir kullanıcıyı silmek için DELETE metodunu kullanırız:
@app.route('/api/users/', methods=['DELETE'])
def delete_user(id):
return jsonify({"message": f"{id} numaralı kullanıcı başarıyla silindi!"}), 200
Bu rota, verilen ID'ye sahip kullanıcıyı siler ve başarılı bir mesaj döndürür.
API Güvenliği ve İleri Düzey Özellikler
Adım 5: API'yi Güçlendirmek
Şimdi API'niz işlevsel hale geldi. Ancak güvenlik de önemli. API’nizi güvence altına almak için JWT (JSON Web Token) veya API anahtarları gibi yöntemleri kullanabilirsiniz. Bu, kullanıcıların doğrulanmasını sağlar ve sadece yetkilendirilmiş kişilerin API'yi kullanmasına olanak tanır.
Sonuç
Artık Flask ile basit ve güçlü bir REST API yapmanın temel adımlarını öğrendiniz. Bu rehberde öğrendiğiniz bilgilerle kendi projelerinizi geliştirebilir ve web dünyasında etkili API'ler oluşturabilirsiniz. Flask, kolay kullanımının yanı sıra oldukça esnek ve güçlüdür, böylece ihtiyacınıza göre özelleştirebilirsiniz. Şimdi, Flask ile kendi API’nizi geliştirmeye başlayabilirsiniz!