Giriş: Flask ile API Geliştirmenin Kolay Yolu
Bir gün, Python ile projeler yaparken API ihtiyacı duyduğunuzu hayal edin. Bunu yaparken karşılaştığınız seçenekler arasında Flask hemen dikkat çeker. Neden mi? Çünkü Flask, basit ve hızlı bir şekilde REST API’leri oluşturmanıza olanak tanır. Hadi, Flask ile bir REST API nasıl yapılır, adım adım birlikte keşfedelim.
Flask, Python tabanlı bir mikro web çerçevesidir. Yani, çok fazla karmaşaya girmeden, yalnızca ihtiyaç duyduğunuz özellikleri kullanarak hızlıca projeler geliştirebilirsiniz. REST API, farklı sistemlerin birbirleriyle veri paylaşmasını sağlayan yaygın bir yapı olduğundan, Flask bu tür projeler için mükemmel bir tercih olacaktır.
Flask ile REST API Kurulumuna Başlayalım
İlk adımımız Flask'ı kurmak olacak. Bunu yapabilmek için terminalinizi açın ve aşağıdaki komutu çalıştırın:
pip install Flask
Kurulum tamamlandıktan sonra, Flask’ı projeye dahil etmek için şu satırı ekleyebilirsiniz:
from flask import Flask
Basit Bir API Oluşturalım
Şimdi ilk REST API'mizi oluşturalım. Basit bir "Hello World" API'si yazacağız. Flask'ta bu oldukça kolay!
Aşağıdaki kodu kullanarak bir API başlatabilirsiniz:
from flask import Flask
app = Flask(__name__)
@app.route('/api', methods=['GET'])
def hello_world():
return "Merhaba, API dünya!"
if __name__ == '__main__':
app.run(debug=True)
Yukarıdaki kodda, `/api` adresine gelen GET isteklerini `hello_world` fonksiyonu ile karşılıyoruz. `app.run(debug=True)` satırı ise uygulamanın geliştirme modunda çalışmasını sağlar.
Şimdi bu dosyayı çalıştırın. Tarayıcınızda `http://127.0.0.1:5000/api` adresine giderek "Merhaba, API dünya!" mesajını görmelisiniz.
Parametrelerle Çalışmak
Gerçek bir API, parametrelerle çalışmak zorundadır. Flask ile dinamik parametreleri nasıl alabileceğinizi görelim.
Aşağıdaki örnekte, bir kullanıcı adı parametresi alacak ve buna göre kişiye özel bir mesaj döndüreceğiz:
@app.route('/api/greet/', methods=['GET'])
def greet_user(username):
return f"Merhaba, {username}!"
Bu API'yi kullanarak `/api/greet/Ahmet` gibi bir URL'e gittiğinizde, "Merhaba, Ahmet!" mesajını alırsınız. Bu tür parametreler API'nizin daha dinamik ve kullanıcı dostu olmasını sağlar.
JSON ile Veri Gönderme ve Alma
Şimdi biraz daha ileri gidelim. Gerçek dünya uygulamalarında genellikle JSON formatında veri gönderilir ve alınır. Flask, JSON verisi ile çalışmak için çok uygun bir yapıya sahiptir.
Aşağıdaki kodu, POST isteği ile JSON verisi gönderecek bir API oluşturmak için kullanabilirsiniz:
from flask import request, jsonify
@app.route('/api/user', methods=['POST'])
def create_user():
data = request.get_json()
username = data.get('username')
email = data.get('email')
return jsonify({"message": f"Kullanıcı {username} başarıyla oluşturuldu!", "email": email})
Bu API, bir POST isteği ile JSON verisi alır ve bunu işler. Veriyi aşağıdaki gibi bir formatta gönderebilirsiniz:
```json
{
"username": "JohnDoe",
"email": "john.doe@example.com"
}
```
API'nin Çalıştığını Test Etmek
Her şey hazır, şimdi API'mizin çalışıp çalışmadığını test edelim. Bunun için `Postman` ya da `cURL` gibi araçlar kullanabilirsiniz. API'ye istek göndermek ve aldığınız cevabı incelemek, geliştirme sürecinin önemli bir parçasıdır.
Örneğin, yukarıda oluşturduğumuz `/api/user` adresine bir POST isteği gönderdiğinizde, JSON formatında şu yanıtı almalısınız:
```json
{
"message": "Kullanıcı JohnDoe başarıyla oluşturuldu!",
"email": "john.doe@example.com"
}
```
Sonuç
Artık Flask ile basit bir REST API'si oluşturmayı öğrendiniz. Flask, projelerde hızlıca API geliştirmek için mükemmel bir araçtır ve temel işlevleri çok basit bir şekilde yapılandırabilirsiniz. Gelişmiş özellikler, kullanıcı doğrulama ve veritabanı entegrasyonları ekleyerek API'nizi daha güçlü hale getirebilirsiniz. Flask ile yolculuğunuz şimdi başlıyor. Haydi, geliştirmeye devam edin!
