1. Flask'ı Kurma: İlk Adım
Her şeyden önce, Python yüklü olduğundan emin olun. Ardından, Flask’ı kurmak için terminal veya komut istemcisine şu komutu yazın:
pip install Flask
```
Bu komut, Flask’ı sisteminize kurarak web uygulamaları geliştirmeye başlamanızı sağlar.
2. Proje Yapısını Oluşturma
Artık Flask kuruldu, projeniz için uygun bir klasör yapısı oluşturmalısınız. Projenizi başlatmak için şu şekilde bir yapı önerilir:
/my_flask_api
/app.py
/requirements.txt
```
Bu yapıyı oluşturduktan sonra, temel API'mizi yazacağımız `app.py` dosyasını açalım.
3. Flask Uygulamasını Başlatma
Şimdi, Flask ile basit bir web uygulaması başlatmak için `app.py` dosyasını açın ve şu kodu yazın:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def home():
return "Merhaba, Flask API!"
if __name__ == '__main__':
app.run(debug=True)
```
Bu kod, uygulamanızı başlatır ve tarayıcıda "Merhaba, Flask API!" mesajını görüntüler.
4. API Endpoint'i Oluşturma
API'nin asıl amacı, belirli bir URL’ye gelen istekleri yanıtlamaktır. Şimdi bir endpoint ekleyelim:
@app.route('/api/greet', methods=['GET'])
def greet():
return {"message": "Merhaba, Flask API!"}
```
Bu endpoint, `/api/greet` adresine GET isteği gönderildiğinde JSON formatında bir yanıt döndürecektir.
5. Veri Gönderme ve Alma
Gerçek dünyada API’ler genellikle veri gönderme ve alma işlemleri yapar. Şimdi, POST isteğiyle veri alalım:
from flask import request
@app.route('/api/echo', methods=['POST'])
def echo():
data = request.get_json()
return {"received_data": data}, 200
```
Bu endpoint, POST isteği ile gönderilen JSON veriyi alır ve geri gönderir. Böylece API’niz, veriyi alıp işleyip geri döndürme işlevi görmüş olur.
6. Veritabanı Bağlantısı Eklemek
Şimdi veritabanı bağlantısı kurarak verilerinizi saklayabiliriz. Flask ile SQLAlchemy gibi bir ORM kullanarak veritabanı bağlantısı kurmak oldukça basittir. Bunun için:
pip install flask_sqlalchemy
```
Ardından, veritabanı bağlantısını yapalım:
```python
from flask_sqlalchemy import SQLAlchemy
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///db.sqlite'
db = SQLAlchemy(app)
```
Veritabanı modeli ekleyip veritabanına veri eklemek de basittir.
7. API’nizi Test Etme
Artık API’niz hazır! Flask’ı çalıştırarak test edebilir ve tarayıcınızda API'nizi ziyaret edebilirsiniz. `http://127.0.0.1:5000/api/greet` adresine giderek yanıtı görebilirsiniz.
Tebrikler! Artık Python Flask kullanarak ilk API'nizi oluşturmuş oldunuz. API geliştirme süreci başlangıçta karmaşık gibi görünse de, Flask'ın hafif yapısı sayesinde oldukça basit hale geliyor. Artık API'nizi geliştirebilir, özellikler ekleyebilir ve daha büyük projelere geçiş yapabilirsiniz.
