Flask ile REST API Yapmak: Adım Adım Kılavuz

Flask, Python dünyasında oldukça popüler bir mikro web framework’üdür. Basit, hafif ve kullanımı kolay olması sayesinde geliştiriciler tarafından çok tercih edilir. Bu yazıda, Flask ile nasıl bir REST API oluşturacağınızı adım adım öğrenmeye başlayacağız. Hadi, Flask dünyasına adım atalım!

Flask ile REST API Nedir?

REST (Representational State Transfer), web servislerinin nasıl çalıştığını tanımlayan bir mimari desendir. REST API’leri, HTTP protokolünü kullanarak farklı sistemler arasında veri iletimi sağlar. Yani, bir istemci (web tarayıcısı, mobil uygulama vs.) ve bir sunucu arasında iletişimi sağlayan yapıdır.

Flask, minimal yapısı ile RESTful API’lerinizi oluştururken size esneklik sağlar. Flask ile sadece birkaç satır kodla harika bir API yaratabilirsiniz. Şimdi, ilk API’mizi yapmaya başlayalım.

Adım 1: Gerekli Paketleri Yükleyin

İlk olarak Flask'ı yüklemelisiniz. Flask’ı yüklemek için terminale şu komutu yazabilirsiniz:

pip install Flask

Eğer JSON veri ile çalışacaksanız, `Flask-RESTful` paketini de yükleyebilirsiniz. Bu paket, API’nizi daha düzenli ve okunabilir yapmanıza yardımcı olur.

pip install Flask-RESTful

Adım 2: Flask Uygulamasını Oluşturun

Şimdi Flask uygulamamızın temelini atıyoruz. Aşağıdaki gibi basit bir Flask uygulaması oluşturacağız.

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Merhaba Flask!'

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

Yukarıdaki kodda, `@app.route()` dekoratörü ile `/` yoluna bir GET isteği yapıldığında çalışan `hello_world` fonksiyonunu tanımlıyoruz. `app.run(debug=True)` ile uygulamanın debug modda çalışmasını sağlıyoruz.

Adım 3: Basit Bir REST API Oluşturun

Şimdi, bir REST API endpoint’i ekleyelim. Diyelim ki, bir "kullanıcı" verisi döndüren bir endpoint yapalım. İşte bu şekilde yapacağız:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/kullanici')
def kullanici():
    # Örnek veri
    user = {
        "id": 1,
        "isim": "Ahmet",
        "soyad": "Yılmaz"
    }
    return jsonify(user)

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

Bu API endpoint’i, `/api/kullanici` adresine gelen GET isteklerine JSON formatında kullanıcı verisi döndürecektir.

Adım 4: POST İstekleri ile Veri Gönderme

Bir REST API’sinin önemli özelliklerinden biri de veri alabilmesidir. Kullanıcıdan veri alabilmek için POST isteğini kullanacağız. Flask'ta POST isteği almak için `@app.route` dekoratörüne `methods=['POST']` parametresi eklemeniz gerekiyor. Örnek olarak, kullanıcıya bir "kullanıcı ekle" fonksiyonu ekleyelim.

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api/kullanici', methods=['POST'])
def yeni_kullanici():
    data = request.get_json()  # JSON verisini al
    id = data['id']
    isim = data['isim']
    soyad = data['soyad']
    yeni_user = {
        "id": id,
        "isim": isim,
        "soyad": soyad
    }
    return jsonify(yeni_user), 201  # Yeni veriyi döndür

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

Yukarıdaki kodda, `request.get_json()` fonksiyonu ile gelen POST isteğindeki JSON verisini alıyoruz ve `jsonify()` ile cevap olarak JSON formatında geri gönderiyoruz.

Adım 5: Error Handling (Hata Yönetimi)

Her iyi API’nin hata yönetimi de olmalıdır. Kullanıcıdan gelen yanlış veri durumunda API’mizin düzgün çalışması için hata mesajları döndürmeliyiz. Flask’ta hata yönetimi oldukça basittir. Bir hata meydana geldiğinde, Flask otomatik olarak 500 hatası döndürür. Ancak, bunu daha anlamlı hale getirebiliriz. Örneğin:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/kullanici/')
def kullanici(id):
    if id != 1:
        return jsonify({"error": "Kullanıcı bulunamadı"}), 404
    return jsonify({"id": id, "isim": "Ahmet", "soyad": "Yılmaz"})

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

Bu kodda, kullanıcı ID’sine göre bir hata mesajı döndürüyoruz. Eğer ID 1 dışında bir şey girilirse, API 404 hata kodu ile bir hata mesajı döndürecektir.

Sonuç

Flask ile REST API yapmak, son derece basit ve eğlenceli bir süreçtir. Kısa sürede işlevsel bir API oluşturabilir ve farklı uygulamalarla entegre edebilirsiniz. Flask’ın esnekliği sayesinde API’nizi dilediğiniz gibi özelleştirebilirsiniz. Bu yazıda Flask ile temel bir API’nin nasıl yapılacağını öğrendiniz. Artık, veritabanı bağlantıları, kimlik doğrulama, hata yönetimi gibi daha ileri seviyedeki konuları keşfetmek için bir adım daha atabilirsiniz.